Nouveautés

Chaque changement de l'API est écrit ici, du plus récent au plus ancien.

Version 1.0 — octobre 2026#

Première version : l'API en lecture.

• Authentification OAuth 2.0 (« client credentials ») : clé d'accès et code de sécurité contre un jeton de 15 minutes.
• 17 ressources en lecture : produits, clients, fournisseurs, devis, commandes de vente, factures, avoirs, paiements reçus, bons de commande, réceptions et retours, transferts, ajustements, succursales, départements, sous-départements, listes de prix, types de client.
• Filtres, tri, pagination et recherche sur chaque liste, et updated_since pour synchroniser.
• Permissions par ressource, et deux compléments (costs:read, customers:financial) qui ouvrent les champs sensibles.
• Restrictions par clé : à certaines succursales, ou à une liste de prix.
• GET /resources : le catalogue de ce que votre clé peut lire.
• Limite de requêtes par minute, avec les en-têtes X-RateLimit-*.
• Description OpenAPI et collection Postman à télécharger.

Notre politique de versions#

L'adresse de l'API contient sa version : /api/v1.

• Ce qui est publié est un engagement. Un champ, un filtre, un code d'erreur de la v1 ne sont ni renommés ni retirés.
• Ce qui peut arriver dans la v1 sans prévenir (ce n'est pas un changement incompatible) : un nouveau champ dans une réponse, un nouveau filtre, une nouvelle ressource, un nouveau code d'erreur pour un nouveau cas. Votre code doit donc ignorer les champs qu'il ne connaît pas.
• Un changement incompatible ouvre une v2. La v1 continue de fonctionner, et nous annonçons ici sa date de fin, avec un préavis suffisant pour que vous ayez le temps de migrer.

Ce qui vient#

L'écriture (créer, modifier, annuler), ressource par ressource. Chaque nouveauté sera annoncée ici avant d'être ouverte.