Skip to content
Gillia Developers v1

Guide

Tester dans le bac à sable

Une boutique d’exemple et une clé de test, pour développer sans toucher aux données d’un commerçant.

Ce que c’est

Le bac à sable est une vraie enseigne Gillia, créée pour vous et remplie d’une boutique d’exemple : catalogue, familles d’articles, horaires et vitrine du métier que vous avez choisi. L’API y répond exactement comme chez un commerçant : mêmes adresses, mêmes droits, mêmes limites, mêmes erreurs.

Créer mon bac à sable prend deux minutes : une adresse e-mail, un clic sur le lien reçu, un mot de passe. Votre première clé s’affiche aussitôt.

Votre clé de test

Elle commence par gsk_test_ au lieu de gsk_ : impossible de la confondre avec la clé d’un commerçant. Elle porte tous les droits qu’une clé peut avoir, sur tous les établissements du bac à sable.

Elle ne s’affiche qu’une fois. Pour en créer d’autres (par exemple une clé limitée à la lecture, pour tester un refus 403), ouvrez le desk du bac à sable : Paramètres › Intégrations › Clés API.

curl https://gillia.app/pos-api/api/v1/sites \
  -H "Authorization: Bearer gsk_test_VOTRE_CLE"

Ce qui change par rapport à un commerçant

Bac à sableCommerçant
Préfixe de clégsk_test_gsk_
DonnéesBoutique d’exemple, à vousDonnées réelles du commerçant
E-mailsNe partent que vers les membres du bac à sablePartent vers les clients
Moyens de paiementAucun branché pour vousCeux du commerçant
Synchronisation comptableCoupéeSelon le commerçant
HubRise, facturation électronique (PDP)Indisponibles : rien ne part chez un partenaire réelSelon le commerçant
Webhooks vers votre serveurEnvoyésEnvoyés
FacturationGratuitAbonnement du commerçant

Le bac à sable n’apparaît dans aucune recherche publique et n’est pas indexé par les moteurs de recherche.

Relire vos appels

Chaque appel fait avec une clé de test est noté pendant 30 jours : méthode, route, code de réponse, durée et l’X-Request-Id reçu. Relisez-les avec votre clé :

curl "https://gillia.app/pos-api/api/v1/me/calls?limit=20" \
  -H "Authorization: Bearer gsk_test_VOTRE_CLE"

Vous n’y voyez que les appels de cette clé. Rien du contenu n’est gardé : ni corps de requête ou de réponse, ni identifiant dans l’adresse (la route est le gabarit, par exemple /api/v1/sites/{siteId}/pos/catalog/products). Une clé de production n’a que des compteurs par jour.

Simuler les incidents

Ajoutez l’en-tête Gillia-Simulate: unavailable (503), rate_limited (429) ou server_error (500) à n’importe quelle route publique : le bac à sable répond comme si l’incident arrivait et n’exécute rien. C’est ainsi que vous éprouvez vos reprises, et que la certification les vérifie.

Bonnes pratiques

  • Un compte, un bac à sable. Vous pouvez inviter vos collègues dans le desk du bac à sable : ils deviennent membres, et les e-mails peuvent leur parvenir.
  • Écrivez sans crainte. Créez des articles, des clients, des commandes partenaires : rien de tout cela n’atteint un vrai client.
  • Testez les erreurs. Une clé sans un droit donne 403, un siteId inconnu donne 404, un rythme trop élevé donne 429 avec Retry-After : voir Limites, erreurs et idempotence.
  • Gardez la clé côté serveur, même de test : elle ouvre le bac à sable à quiconque la possède.

Passer chez un vrai commerçant

Rien à changer dans votre code, sauf la clé : le commerçant crée une clé gsk_ dans ses propres paramètres et vous la transmet. Les adresses, les droits et les réponses sont les mêmes.