Skip to content
Gillia Developers v1

Guide

Versions et compatibilité

Ce qui peut changer dans l’API, ce qui ne changera pas, et comment vous êtes prévenu.

La règle de la version 1

Toutes les adresses commencent par /api/v1. Tant que c’est v1, les changements ne font qu’ajouter :

  • une nouvelle route ;
  • un nouveau champ dans une réponse ;
  • un nouveau paramètre facultatif ;
  • une nouvelle valeur dans une liste de codes (par exemple un nouvel événement de webhook, que vous ne recevez que si vous le demandez).

Ce qui ne se fera pas dans la version 1 : retirer ou renommer un champ, changer son type ou son sens, rendre obligatoire un paramètre facultatif, changer le comportement par défaut d’une route.

Ce que votre code doit tolérer

  • Des champs inconnus dans les réponses : ignorez-les.
  • Des valeurs inconnues dans une liste de codes : traitez-les comme « autre ».
  • L’ordre des champs et des éléments d’une liste non triée.

Avant une version 2

Si une rupture devenait nécessaire, elle arriverait dans une version 2, sous /api/v2. La version 1 resterait servie au moins 12 mois après l’annonce, et les intégrateurs connus seraient prévenus par e-mail.

Suivre les changements

Le contrat OpenAPI porte un numéro de version (info.version) : il change à chaque ajout. La référence et le contrat sont régénérés à chaque évolution, et un test vérifie qu’ils disent la même chose que le code.

VersionDateChangements
1.5.022/10/2026Lecture comptable : écritures (GET …/accounting/entries) et FEC (GET …/accounting/fec) de l’enseigne, droit pos.accounting.read.
1.4.022/10/2026Certification automatique par l’API (/me/apps/{clientId}/certification), webhook de test (POST …/partner-webhook/test), incidents simulés dans le bac à sable (Gillia-Simulate).
1.3.022/10/2026OAuth 2 (code d’autorisation + PKCE) pour les applications multi-commerçants ; inscription des applications par l’API : /me/apps.
1.2.022/10/2026Bac à sable en libre-service (clés gsk_test_). Journal des appels de sa clé : GET /me/calls.
1.1.022/10/2026Portail public. Limite de débit (429 et Retry-After), en-tête X-Request-Id. Toute clé lit ses propres établissements. Routes réservées à la caisse retirées du contrat public.
1.0.009/2026Première version : établissements, catalogue, clients, ventes, clôtures, stock, commandes, commandes partenaires et webhooks, réceptions, bons d’achat.