HilfeAPIFehler und Limits

Fehler und Limits

Jeder Fehlercode der öffentlichen API, die Limit-Tabelle je Plan, und was passiert, wenn du sie überschreitest.

Eine Fehlerform, ein Ort, um jeden Code nachzuschlagen.

Jeder Fehlschlag von /api/v1 antwortet mit derselben Body-Form:

{
  "error": "TEMPLATE_NOT_FOUND",
  "message": "No Template with this id exists for this account."
}

Entscheide anhand des Felds error, nie anhand des Nachrichtentexts — die Nachricht ist für einen Menschen, der Logs liest, nicht für deinen Code zum Parsen.

Jeder Fehlercode

Code	Status	Nachricht
`API_KEY_INVALID`	401	The API Key is malformed, unknown, revoked, or its account is inactive.
`API_KEY_MISSING`	401	Send the API Key as an `Authorization: Bearer` header.
`CONCURRENCY_LIMIT_REACHED`	429	This account already has the maximum number of Runs in flight for its plan.
`EXPORT_LIMIT_REACHED`	402	This account has used its Quota for the current billing period.
`FILE_TOO_LARGE`	413	The uploaded file exceeds this plan's upload size ceiling.
`IDEMPOTENCY_KEY_REUSED`	409	This `Idempotency-Key` was already used for a different request.
`INSUFFICIENT_SCOPE`	403	The API Key does not carry the scope this operation requires.
`INVALID_IDEMPOTENCY_KEY`	422	`Idempotency-Key` must be 1-255 printable characters.
`INVALID_PARSE_PARAMS`	422	`delimiter` must be one printable character; `header_row` must be a non-negative integer within the row ceiling.
`MALFORMED_FILE`	400	The file could not be read: it is empty, corrupt, or not encoded as expected.
`NO_SUBSCRIPTION`	403	This account has no active subscription.
`RATE_LIMITED`	429	This account has exceeded its request rate limit for this operation.
`ROW_LIMIT_EXCEEDED`	413	The uploaded file exceeds this plan's row ceiling.
`RUN_NOT_FOUND`	404	No Run with this id exists for this account. Runs are kept 30 minutes and are lost if the service restarts.
`SERVER_BUSY`	503	This worker is at its memory budget; retry shortly.
`TEMPLATE_COLUMNS_MISSING`	422	The uploaded file is missing one or more columns this Template's operations require.
`TEMPLATE_NOT_FOUND`	404	No Template with this id exists for this account.
`UNSUPPORTED_FILE_TYPE`	415	This file type is not supported.

Kontingent und Nebenläufigkeit

Die monatlichen Läufe deines Plans zu überschreiten antwortet 402 EXPORT_LIMIT_REACHED, mit einem quota-Objekt (verbraucht, Limit, wann es sich zurücksetzt). Mehr Läufe gleichzeitig zu starten, als die Nebenläufigkeit deines Plans erlaubt, antwortet 429 CONCURRENCY_LIMIT_REACHED. Anfragen schneller zu senden, als es die Rate deines Kontos erlaubt, antwortet mit einem zweiten, eigenen 429 RATE_LIMITED. Ein Worker an seinem Speicherbudget antwortet 503 SERVER_BUSY — versuche es in Kürze erneut.

Jede Antwort von /api/v1 trägt die Header X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset für das Fenster, gegen das diese Anfrage geprüft wurde, damit ein Skript bremsen kann, bevor es abgelehnt wird.

Was nichts kostet

Vorlagen aufzulisten und den Status oder das Ergebnis eines Laufs abzufragen verbraucht nie dein monatliches Kontingent. Nur ein Lauf, der fertig wird und eine Datei liefert, zählt — ein abgelehnter, fehlgeschlagener, abgelaufener, unterbrochener oder idempotent wiedergegebener Lauf wird nie berechnet.

Limits je Plan

Plan	Zeilen je Datei	Läufe pro Monat	Vorlagen	Verbundene Dateien pro Monat	Gleichzeitige Läufe
Free	5,000	5	2	0	1
Pro	100,000	50	10	5	2
Business	500,000	Unbegrenzt	Unbegrenzt	Unbegrenzt	3
Enterprise	1,000,000	Unbegrenzt	Unbegrenzt	Unbegrenzt	5

Das vollständige Detail zu jedem Plan steht auf der Preisseite.