REST-API

Bereiche

Erste Schritte Buchhaltung & Finanzen Personalwesen Dokumentenmanagement Analyse & Steuerung Plattform Datenresidenz

Plattform

Core Dynamische Formulare KI-Chat Import / Export REST-API MCP Server

REST-API

REST-API

AltiusOne stellt eine vollständige REST-API bereit, basierend auf Django REST Framework, dokumentiert mit OpenAPI (drf-spectacular).

Authentifizierung

Die API verwendet JWT (JSON Web Tokens) über SimpleJWT:

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

# Token verwenden
curl -H "Authorization: Bearer <access_token>" \
  /api/v1/comptabilite/ecritures/

Hauptendpunkte

Modul Endpunkt Operationen
Buchhaltung /api/v1/comptabilite/ CRUD Buchungen, Konten
Rechnungsstellung /api/v1/facturation/ CRUD Rechnungen, Offerten
MWST /api/v1/tva/ MWST-Abrechnungen
Lohn /api/v1/salaires/ Lohnabrechnungen, Zertifikate
Dokumente /api/v1/documents/ Upload, Suche
Projekte /api/v1/projets/ Projekte, Aufgaben
Graph /api/v1/graph-*/ Entitäten, Beziehungen

OpenAPI-Dokumentation

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

OAuth2 / OIDC

AltiusOne ist auch ein OAuth2/OIDC-Provider, was ermöglicht:

  • SSO mit Nextcloud über user_oidc
  • Integration mit Drittanbieter-Anwendungen
  • Mobile Authentifizierung (React Native App)

Interaktionen

  • Mobile — Die React-Native-App nutzt die REST-API
  • Nextcloud — SSO über den OIDC-Provider
  • MCP — Der MCP-Server nutzt die interne API
  • Import/Export — Importe können über die API durchgeführt werden
Import / Export
Auf dieser Seite