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 à sable | Commerçant | |
|---|---|---|
| Préfixe de clé | gsk_test_ | gsk_ |
| Données | Boutique d’exemple, à vous | Données réelles du commerçant |
| E-mails | Ne partent que vers les membres du bac à sable | Partent vers les clients |
| Moyens de paiement | Aucun branché pour vous | Ceux du commerçant |
| Synchronisation comptable | Coupée | Selon le commerçant |
| HubRise, facturation électronique (PDP) | Indisponibles : rien ne part chez un partenaire réel | Selon le commerçant |
| Webhooks vers votre serveur | Envoyés | Envoyés |
| Facturation | Gratuit | Abonnement 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, unsiteIdinconnu donne404, un rythme trop élevé donne429avecRetry-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.