Getting started
Introduzione
Documentation for the REST APIs and MCP server that bring esimoa eSIMs to your website, app or AI assistant.
What you can build#
- API di ricerca eSIM — Cerca le eSIM di esimoa per paese, durata e dati e mostrale con i prezzi in tempo reale sul tuo sito o nella tua app.
- Commissione sui link di tracciamento — Ogni link di acquisto nella risposta API contiene il tuo codice partner. Quando un cliente paga tramite il link, guadagni una commissione.
- Integrazioni IA (MCP) — Collega il server MCP di esimoa a ChatGPT, Claude o Gemini e l’IA potrà cercare, confrontare e linkare le eSIM.
- API per partner (B2B) — Rivenditori e partner B2B con contratto possono recuperare lato server il catalogo prodotti esimoa per creare i propri negozi.
Which API should I use?#
esimoa ha due API REST con chiavi separate. Per la maggior parte di siti web, blog e prodotti IA basta la Public API.
| API pubblica (/v1) | API per partner (B2B) | |
|---|---|---|
| Destinatari | Affiliati — chiunque abbia un account esimoa | Rivenditori e partner B2B con contratto |
| Emissione delle chiavi | Dashboard del Centro sviluppatori | Portale partner |
| Formato della chiave | esk_live_<32> | esk_live_<10>_<40> |
| URL di base | https://api.esimoa.com/v1 | https://api.esimoa.com/b2b/v1 |
| Come guadagni | Commissione sugli acquisti effettuati tramite i link di tracciamento nelle risposte | Secondo il tuo contratto |
Come funziona#
- 1Accedi con il tuo account esimoa, inserisci i dati del tuo sito e ottieni subito un codice partner.
- 2Crea una chiave API nella dashboard. La chiave viene mostrata una sola volta.
- 3Mostra i prodotti dell’API insieme al relativo url (che contiene il tuo codice partner).
- 4Quando un cliente paga tramite il link, la commissione viene registrata nella tua dashboard.