Intégrer avec l’IA
Un contexte prêt à copier pour votre assistant de développement.
Donner le bon contexte
Copiez ce prompt dans votre assistant, puis précisez votre langage et votre framework. Utilisez les pages de référence pour contrôler les champs et les réponses.
Intègre eSIMY Partners côté serveur dans mon application.
Documentation : https://esimy.siraj-ai.com/developers
Base API : https://esimy.siraj-ai.com/api/v1
Authentification : Authorization: Bearer <ESIMY_API_KEY>
La clé est une variable d'environnement serveur, jamais publique.
Parcours :
1. GET /catalogue?country=FR&page=1 pour choisir un code de forfait.
2. POST /quotes avec {packageCode, days} ; le devis expire après 5 minutes.
3. Afficher amountUnits / 10000 en USD et demander confirmation.
4. POST /orders avec {quoteId, reference} et Idempotency-Key.
5. GET /orders/{id} toutes les 10 secondes pendant la préparation.
6. À ready, GET /orders/{id}/esim pour livrer le QR code au voyageur.
Contraintes :
- Tous les montants sont des entiers en 1/10 000 USD.
- Les 10 % sont déjà inclus dans le devis : ne pas les ajouter à nouveau.
- Conserver la même clé d'idempotence ET le même contenu lors d'une reprise.
- Gérer les erreurs {error:{code,message}} et les HTTP 401, 402, 403, 409, 429, 503.
- Lire le solde via GET /wallet (wallet:read).
- Les recharges B-PAY et les clés sont gérées dans le portail agence.
- Pas de sandbox public ni de webhooks sortants.
- Ne lancer aucun achat réel pendant le développement.
- Utiliser des transports simulés pour les tests et ne jamais journaliser de secret.Avant de connecter votre application
Vérifiez que la clé ne figure ni dans le bundle client ni dans le dépôt de code.
Testez les réponses d’erreur et les reprises avec des données simulées.
Vérifiez les calculs en unités entières et le stockage de la clé d’idempotence.
N’activez les commandes réelles qu’après validation du parcours et du prix présenté au client.