Docs

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:

JSON
{
  "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.