Overview
Öffentliche API (/v1)
Shared rules of the /v1 API: base URL, response envelope, pagination and response language.
Basis-URL#
Sende jede Anfrage per HTTPS an die Adresse unten. Ein Schlüssel für die öffentliche API ist erforderlich (Authentifizierung) und jede Antwort ist JSON.
https://api.esimoa.com/v1Endpunkte#
| Endpunkt | Beschreibung |
|---|---|
| GET /v1/esims | eSIMs suchen |
| GET /v1/esims/:id | eSIM holen |
| GET /v1/countries | Länder auflisten |
| GET /v1/openapi.json | OpenAPI-3.1-Spezifikation (kein Schlüssel nötig) |
Response envelope#
Erfolgreiche Antworten enthalten immer "success": true. Listen stehen in items, ein einzelnes Ergebnis in item.
// List endpoints
{ "success": true, "items": [ ... ], "total": 42, "limit": 10, "offset": 0, "sort": "price" }
// Detail endpoint
{ "success": true, "item": { ... } }Fehlerantworten und Statuscodes findest du unter Ratenlimits & Fehler.
Seitennavigation#
Listen werden mit limit (1–50, Standard 10) und offset paginiert. offset wird immer auf ein Vielfaches von limit abgerundet – z. B. wird limit=10, offset=15 als offset=10 behandelt. Der offset in der Antwort ist der tatsächlich verwendete Wert, total ist die Gesamtzahl.
Trinkgeld
Response language#
Der Parameter lang (ko | en | ja | zh-CN | zh-TW, Standard en) legt die Sprache der Ländernamen, Artikeltitel und der Kaufseite fest, auf die url verweist. Passe sie an die Sprache deiner Nutzer an.
Prices & caching#
Preise (priceKrw) sind der esimoa-Verkaufspreis als ganzzahliger KRW-Betrag. Preise ändern sich häufig – speichere Suchergebnisse höchstens wenige Minuten im Cache; maßgeblich für den abgebuchten Betrag ist immer der esimoa-Checkout.