Fehler und Rate Limits
Fehlerformat von AdLib, Fehlercodes, Rate Limits pro Minute je Plan, Rate-Limit-Header und wie du es erneut versuchst.
Fehlerformat
Fehler kommen mit einem JSON-Body und einem maschinenlesbaren Code zurück:
{
"error": {
"code": "not_found",
"message": "ad meta:123 not found",
"request_id": "c821fd4d-699b-4080-9776-841f4b57aad2",
"billed": false
}
}Fehler werden nie berechnet. Gib die request_id (steht auch im Header X-Request-Id) an, wenn du uns kontaktierst.
Codes
| Code | Bedeutung | Was du tun kannst |
|---|---|---|
bad_request |
Ein Parameter fehlt oder ist ungültig; details sagt, welcher |
Anfrage korrigieren |
invalid_cursor |
Der cursor stammt nicht aus einem next_cursor |
next_cursor unverändert zurückgeben |
invalid_webhook_url |
Die Webhook-URL ist keine öffentliche http(s)-Adresse (localhost, private, Link-Local- und interne Hosts werden abgelehnt) | Eine URL nehmen, die aus dem Internet erreichbar ist |
interval_too_short |
interval_hours liegt unter dem, was dein Konto erlaubt (24 mit den kostenlosen Credits, 6, sobald du ein Paket gekauft hast) |
interval_hours erhöhen oder ein Paket kaufen |
watchlist_too_large |
Die Watchlists würden mehr Marken beobachten, als dein Konto erlaubt (3 mit den kostenlosen Credits, 250 nach einem Paket) | Marken entfernen oder ein Paket kaufen |
batch_too_large |
Mehr Einträge in einem Batch, als dein Konto erlaubt (10 mit den kostenlosen Credits, 100 nach einem Paket) | Batch aufteilen |
unauthorized |
API-Key fehlt oder ist ungültig | Header X-API-Key prüfen |
account_blocked |
Das Konto ist gesperrt | Uns kontaktieren |
history_limit |
Die Anzeige ist älter als das Archiv deines Kontos (12 Monate mit den kostenlosen Credits) | Ein Paket kaufen für das ganze Archiv |
not_found |
Die Anzeige, der Werbetreibende, der Job oder der Endpoint existiert nicht | ID oder Pfad prüfen |
rate_limited |
Mehr Anfragen pro Minute, als dein Konto erlaubt (30 mit den kostenlosen Credits, 300 nach einem Paket) | Retry-After Sekunden warten |
quota_exceeded |
Kostenlose Credits und Pakete aufgebraucht | Ein Paket kaufen; nicht erneut versuchen |
upstream_error |
Die Bibliothek der Plattform ist ausgefallen oder hat die Anfrage blockiert | Später erneut versuchen; Status prüfen |
internal_error |
Bei uns ist etwas schiefgegangen | Erneut versuchen; Bescheid geben, wenn es anhält |
Rate Limits
| Konto | Anfragen pro Minute |
|---|---|
| Mit den kostenlosen Credits | 30 |
| Nach dem ersten Credit-Paket | 300 |
Jede Antwort enthält X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset (Sekunden, bis das Zeitfenster zurückgesetzt wird). Über dem Limit antwortet die API mit 429 rate_limited und einem Retry-After-Header.
Wiederholungen
Wiederhole rate_limited, upstream_error und internal_error mit Backoff. Wiederhole bad_request, unauthorized, not_found und quota_exceeded nicht. Plattformen ändern ihre Bibliotheken manchmal ohne Ankündigung. Geht dabei eine kaputt, schlagen ihre Calls schnell fehl, werden nicht berechnet und erscheinen auf der Statusseite.