Guides
Ratenlimits & Fehler
Public API per-account rate limits, error response format, status codes and caching guidance.
On this page
Rate limits#
Hinweis
Öffentliche API und authentifiziertes MCP teilen sich ein stündliches Kontingent pro Partner (standardmäßig 20.000). Zusätzliche oder rotierte Schlüssel erhöhen es nicht.
Das 3,600-Sekunden-Fenster beginnt mit der ersten Anfrage; das Minutenlimit gilt zusätzlich. Kontingente zählen Aufrufe, nicht übertragene MB. Betriebliche Einstellungen können das Kontingent ändern.
MCP-Batches akzeptieren bis zu 100 Nachrichten, jede Nachricht zählt als ein Aufruf. Ein Batch, der das verfügbare Kontingent überschreitet, liefert vor der Ausführung 429.
X-RateLimit-Hour-Limit · X-RateLimit-Hour-Remaining · X-RateLimit-Hour-Reset
Diese Header melden das Stundenlimit, die verbleibenden Aufrufe und die Rücksetzzeit (Unix-Sekunden). Ist das Stundenlimit erschöpft, wird HTTP 429 mit Retry-After in Sekunden zurückgegeben. Vom Minutenlimit abgelehnte Aufrufe zählen nicht zum Stundenkontingent.
Standardmäßig sind pro Partnerkonto 600 Anfragen pro Minute erlaubt. Darüber hinaus erhältst du 429 rate_limited.
Trinkgeld
Status codes#
| HTTP | Bedeutung |
|---|---|
| 200 | Erfolgreich |
| 400 | Ungültige Parameter |
| 401 invalid_api_key | Schlüssel fehlt, ist falsch oder widerrufen |
| 404 | Unbekannte eSIM-ID |
| 429 rate_limited | Ratenlimit überschritten |
Error format#
// 401 — missing, invalid or revoked key
{
"error": "invalid_api_key",
"message": "Missing or invalid API key. Create one at https://www.esimoa.com/developers/dashboard"
}
// 429 — too many requests for this key
{ "error": "rate_limited", "message": "Rate limit exceeded (600 requests per minute)." }
// 400 — invalid parameters / 404 — unknown eSIM id
{ "statusCode": 404, "message": "eSIM not found", "error": "Not Found" }Caching#
Preise ändern sich häufig – speichere Suchergebnisse höchstens wenige Minuten im Cache.