Installation et consommation
Récupérez le QR code et consultez l’utilisation des données.
Récupérer l’eSIM
GET /orders/{id}/esim
Permission :
orders:readcurl 'https://esimy.siraj-ai.com/api/v1/orders/ao_EXEMPLE/esim' \
-H "Authorization: Bearer $ESIMY_API_KEY"{
"orderId": "ao_EXEMPLE",
"iccid": "ICCID_FOURNISSEUR",
"activationCode": "LPA:1$ADRESSE_SMDP$CODE_ACTIVATION",
"qrCodeUrl": "https://example.invalid/qr-exemple.png",
"status": "ready",
"expiresAt": "2026-11-24T12:00:00Z",
"apn": "APN_FOURNISSEUR"
}| Champ | Usage |
|---|---|
iccid | Identifiant de la carte eSIM. |
qrCodeUrl | URL du QR code retourné par le fournisseur. |
activationCode | Code d’installation manuelle retourné par le fournisseur. |
status | État observé auprès du fournisseur. |
expiresAt / apn | Valeurs fournisseur ; leur présence ou format peut dépendre du forfait. |
Le QR code et le code d’activation sont confidentiels. Transmettez-les uniquement au voyageur concerné ; ne les exposez pas dans une page publique ou dans vos logs.
Consulter la consommation
GET /orders/{id}/usage
Permission :
orders:readcurl 'https://esimy.siraj-ai.com/api/v1/orders/ao_EXEMPLE/usage' \
-H "Authorization: Bearer $ESIMY_API_KEY"{
"orderId": "ao_EXEMPLE",
"usedBytes": 268435456,
"totalBytes": 1073741824,
"updatedAt": "2026-11-17T13:00:00Z"
}Les volumes sont exprimés en octets. Divisez par 1 073 741 824 pour afficher des GiB. updatedAt représente la valeur de mise à jour retournée par le fournisseur ; la consommation peut ne pas être instantanée.
Disponibilité et erreurs
| HTTP / code | Action |
|---|---|
409 esim_not_ready | L’eSIM est encore en préparation. Poursuivez le suivi de commande. |
404 | Vérifiez l’identifiant et son appartenance à votre agence. |
503 supplier_unavailable / usage_unavailable | Réessayez plus tard avec un délai progressif. |
502 provider_mismatch | Demandez une vérification à l’équipe eSIMY. |