Stable Pro API · v1
Environnement de test
Staging, clés de test et données de test : construisez votre intégration sans toucher à de vrais comptes.
Le staging est une copie complète de Stable Pro avec des données de test, pour construire et tester une intégration :
| Production | Staging | |
|---|---|---|
| URL de base | https://app.stable-pro.com/api/v1 | https://staging.stable-pro.com/api/v1 |
| Clés | sp_live_… | sp_test_… |
| Données | réelles | données de test uniquement |
Les deux environnements sont séparés : une clé sp_test_ est refusée en production, et une clé sp_live_ sur le staging (401, reason: wrong_environment). Le contrat est le même.
Obtenir une clé de test
Le titulaire d'une écurie de test sur le staging crée la connexion dans Paramètres → Connexions, exactement comme en production, et vous remet la clé sp_test_. Quand la fenêtre affiche la clé, elle indique aussi que c'est une clé de test et qu'elle ne fonctionne que dans cet environnement.
Que tester
- Lisez l'historique depuis le début avec
GET /events, puis continuez à lire depuis votre curseur pendant que quelqu'un travaille dans l'écurie : des débits, une remise, un encaissement avec son reçu, un remboursement. - Gérez les corrections : une correction après une facture est un fait nouveau, avec son motif ; votre logiciel émet son propre document, par exemple un avoir.
- Gérez les erreurs : une clé révoquée (
401), une autorisation manquante (403), la limite de requêtes (429). - Acceptez les codes que vous ne connaissez pas encore : les listes de codes sont ouvertes.