Démarrage rapide
De votre clé API à votre premier appel, en quelques étapes.
Préparer votre environnement
Activez votre accès agence puis créez une clé avec les permissions nécessaires. Conservez-la dans les variables d’environnement de votre serveur. Ne l’ajoutez pas au code d’un navigateur ou d’une application mobile.
export ESIMY_API_KEY="VOTRE_CLE_ESIMY"Votre premier appel
La lecture du solde ne débite rien. Elle nécessite la permission wallet:read.
curl 'https://esimy.siraj-ai.com/api/v1/wallet' \
-H "Authorization: Bearer $ESIMY_API_KEY"{
"balanceUnits": 0,
"currency": "USD",
"moneyScale": 10000,
"items": [],
"topups": []
}Le parcours d’une commande
Consultez le catalogue avec GET /catalogue et conservez le code du forfait.
Créez un devis avec POST /quotes pour connaître le montant final.
Créez la commande avec POST /orders et une clé Idempotency-Key unique. Cette étape débite le solde.
Interrogez GET /orders/{id} toutes les 10 secondes. À l’état ready, récupérez l’eSIM et transmettez son QR code au voyageur.
Vérifiez le prix du devis et le solde disponible avant de confirmer une commande. Une réponse
202 confirme l’enregistrement, pas encore la livraison.