ELRM developer Bac à sable

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_blocked ou 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.