Environnements#
Deux environnements, mêmes chemins, mêmes réponses. Seuls l'URL de base et le préfixe de clé changent.
| Bac à sable | Production | |
|---|---|---|
| URL de base | https://developer.elrm.app/sandbox/v1 |
https://prod.elrm.app/api/v1/partner |
| Préfixe des clés | pk_test_ |
pk_live_ |
| Données | Fictives, réinitialisées chaque semaine | Vos clients et dossiers réels |
| Effets de bord | Aucun : pas d'email, pas de signature, pas d'appel financeur | Réels |
| Quota | 300 requêtes / minute | Défini avec votre clé |
Bac à sable#
Le bac à sable fait tourner le même code que la production, branche pour branche : une route qui fonctionne ici fonctionne en production, au format près des données. Ce qui diffère :
- Les données sont fictives. Le catalogue (formations, offres, prix) est une copie de celui de la production ; les sessions, clients et dossiers sont générés.
- Les actions sortantes sont neutralisées dans le code (pas seulement par configuration) : aucun email n'est envoyé, aucune demande de signature n'est créée, aucun appel n'est fait aux financeurs (Wedof / CPF). Une opération qui en aurait besoin en production répond ici
503 sandbox_outbound_blockedou est journalisée sans effet, selon le cas, le flux de test continue. - La base est réinitialisée chaque semaine (dimanche, 5 h). Vos dossiers de test disparaissent et les identifiants changent ; votre clé reste valable.
Voir la page Bac à sable pour le jeu de données et les limites.
Production#
L'API de production est servie par la plateforme ELRM sous https://prod.elrm.app/api/v1/partner. Votre clé y est rattachée à votre client par ELRM : GET /me le renvoie.
Basculer#
Ne dupliquez pas votre code : rendez l'URL de base et le jeton configurables et gardez tout le reste identique.
import os, httpx
api = httpx.Client(
base_url=os.environ["ELRM_API_BASE_URL"], # https://developer.elrm.app/sandbox/v1 ou https://prod.elrm.app/api/v1/partner
headers={"Authorization": f"Bearer {os.environ['ELRM_API_KEY']}"},
timeout=30,
)
Un contrôle bon marché au démarrage de votre application : vérifiez que le préfixe de la clé (pk_test_ / pk_live_) correspond bien à l'URL configurée. C'est l'erreur de configuration la plus fréquente, et l'API répondra 401 sans plus d'explication.
Sélecteur de serveur dans la référence#
La référence interactive liste les deux serveurs. La console d'essai envoie les requêtes à celui que vous sélectionnez, avec le jeton que vous saisissez, un jeton de test sur le serveur bac à sable, un jeton de production sur le serveur de production.