Developpeurs

Documentation API

Référence technique de l'API MAOS pour les developpeurs et integrateurs.

Swagger / OpenAPI

Documentation interactive de l'API REST

Accedez à la documentation Swagger interactive pour explorer tous les endpoints de l'API MAOS, tester les requêtes en direct et consulter les schemas de données. Disponible uniquement pour les abonnes au pack PRO+.

Ouvrir la documentation Swagger

Informations générales

Base URL

https://www.maossoft.com/api

Authentification

L'API utilise des tokens JWT (JSON Web Token). Incluez le token dans le headerAuthorization: Bearer <token>de chaque requête.

Format des réponses

Toutes les réponses sont au format JSON avec la structure :

{
  "success": true,
  "data": { ... },
  "meta": {
    "total": 150,
    "page": 1,
    "pageSize": 20
  }
}

Rate Limiting

Les requêtes sont limitées à 10/seconde, 50/10 secondes et 200/minute par IP. Les headers de réponse incluent les informations de limite restante.

Modules API disponibles

Sales (Ventes)
Purchase (Achats)
Stock (Inventaire)
CRM (Clients)
Accounting (Comptabilite)
HR (Ressources Humaines)
Reports (Rapports)
AI (Assistant IA)