API REST

Sezioni

Primi passi Contabilità & Finanze Risorse umane Gestione documentale Analisi & Gestione Piattaforma Residenza dei dati

Piattaforma

Core Moduli dinamici Chat IA Import / Export API REST MCP Server

API REST

API REST

AltiusOne espone un'API REST completa basata su Django REST Framework, documentata con OpenAPI (drf-spectacular).

Autenticazione

L'API utilizza JWT (JSON Web Tokens) tramite SimpleJWT:

# Ottenere un token
curl -X POST /api/token/ \
  -d '{"username": "user", "password": "pass"}'

# Utilizzare il token
curl -H "Authorization: Bearer <access_token>" \
  /api/v1/comptabilite/ecritures/

Endpoint principali

Modulo Endpoint Operazioni
Contabilità /api/v1/comptabilite/ CRUD registrazioni, conti
Fatturazione /api/v1/facturation/ CRUD fatture, preventivi
IVA /api/v1/tva/ Conteggi IVA
Salari /api/v1/salaires/ Buste paga, certificati
Documenti /api/v1/documents/ Upload, ricerca
Progetti /api/v1/projets/ Progetti, attività
Grafo /api/v1/graph-*/ Entità, relazioni

Documentazione OpenAPI

  • Swagger UI — /api/docs/
  • ReDoc — /api/redoc/
  • Schema OpenAPI — /api/schema/

OAuth2 / OIDC

AltiusOne è anche un provider OAuth2/OIDC, che permette:

  • SSO con Nextcloud tramite user_oidc
  • Integrazione con applicazioni terze
  • Autenticazione mobile (app React Native)

Interazioni

  • Mobile — L'app React Native consuma l'API REST
  • Nextcloud — SSO tramite il provider OIDC
  • MCP — Il server MCP utilizza l'API interna
  • Import/Export — Le importazioni possono essere effettuate tramite l'API
Import / Export
In questa pagina