Getting started
Einführung
Documentation for the REST APIs and MCP server that bring esimoa eSIMs to your website, app or AI assistant.
What you can build#
- eSIM-Such-API — Suche esimoa-eSIMs nach Land, Dauer und Datenvolumen und zeige sie mit Live-Preisen auf deiner Website oder in deiner App.
- Provision über Tracking-Link — Jeder Kauflink in der API-Antwort enthält deinen Partnercode. Wenn ein Kunde darüber bezahlt, erhältst du eine Provision.
- KI-Integrationen (MCP) — Verbinde den esimoa-MCP-Server mit ChatGPT, Claude oder Gemini, damit die KI eSIMs suchen, vergleichen und verlinken kann.
- Partner-API (B2B) — B2B-Wiederverkäufer und Partner mit Vertrag können den esimoa-Produktkatalog serverseitig abrufen, um eigene Shops aufzubauen.
Which API should I use?#
esimoa bietet zwei REST-APIs mit getrennten Schlüsseln. Für die meisten Websites, Blogs und KI-Produkte reicht die Public API.
| Öffentliche API (/v1) | Partner-API (B2B) | |
|---|---|---|
| Zielgruppe | Affiliates – alle mit einem esimoa-Konto | B2B-Wiederverkäufer und Partner mit Vertrag |
| Schlüsselausgabe | Dashboard des Entwicklerbereichs | Partnerportal |
| Schlüsselformat | esk_live_<32> | esk_live_<10>_<40> |
| Basis-URL | https://api.esimoa.com/v1 | https://api.esimoa.com/b2b/v1 |
| So verdienst du | Provision auf Käufe über die Tracking-Links in den Antworten | Gemäß deinem Vertrag |
So funktioniert’s#
- 1Melde dich mit deinem esimoa-Konto an, gib die Daten deiner Website ein und erhalte sofort einen Partnercode.
- 2Erstelle im Dashboard einen API-Schlüssel. Er wird nur einmal angezeigt.
- 3Zeige Produkte aus der API zusammen mit ihrer url an (die deinen Partnercode enthält).
- 4Wenn ein Kunde über den Link bezahlt, wird die Provision in deinem Dashboard erfasst.