Getting started
Introduction
Documentation for the REST APIs and MCP server that bring esimoa eSIMs to your website, app or AI assistant.
What you can build#
- API de recherche d’eSIM — Recherchez les eSIM esimoa par pays, durée et données, et affichez-les avec les prix en temps réel sur votre site ou application.
- Commission sur lien de suivi — Chaque lien d’achat de la réponse API contient votre code partenaire. Lorsqu’un client paie via ce lien, vous touchez une commission.
- Intégrations IA (MCP) — Connectez le serveur MCP d’esimoa à ChatGPT, Claude ou Gemini pour que l’IA puisse rechercher, comparer et proposer des liens vers des eSIM.
- API partenaire (B2B) — Les revendeurs et partenaires B2B sous contrat peuvent récupérer le catalogue de produits esimoa côté serveur pour créer leurs propres boutiques.
Which API should I use?#
esimoa propose deux API REST avec des clés distinctes. Pour la plupart des sites web, blogs et produits IA, la Public API suffit.
| API publique (/v1) | API partenaire (B2B) | |
|---|---|---|
| Public cible | Affiliés — toute personne disposant d’un compte esimoa | Revendeurs et partenaires B2B sous contrat |
| Émission des clés | Tableau de bord de l’Espace développeurs | Portail partenaire |
| Format de la clé | esk_live_<32> | esk_live_<10>_<40> |
| URL de base | https://api.esimoa.com/v1 | https://api.esimoa.com/b2b/v1 |
| Comment vous gagnez | Commission sur les achats effectués via les liens de suivi des réponses | Selon votre contrat |
Fonctionnement#
- 1Connectez-vous avec votre compte esimoa, saisissez les informations de votre site et obtenez instantanément un code partenaire.
- 2Créez une clé API dans le tableau de bord. La clé ne s’affiche qu’une seule fois.
- 3Affichez les produits de l’API avec leur url (qui contient votre code partenaire).
- 4Quand un client paie via le lien, la commission est enregistrée dans votre tableau de bord.