Warum lehnt die UtilitySEO-API meine Anfrage ab?
Auf dieser Seite
Jede Ablehnung durch die API hat einen HTTP-Status und einen kurzen code, der den Grund nennt. Die häufigsten sind unauthorized (401: Der Schlüssel fehlt, ist falsch oder widerrufen), forbidden (403: Dem Schlüssel fehlt die Berechtigung, oder das Konto hat keinen aktiven Tarif), rate_limited oder scan_limit_reached (429: warten und erneut versuchen) und scan_running (409: Es läuft bereits ein Scan).
Das Bild zeigt die englische Ansicht. Übersetzte Bilder folgen in Kürze.
Fehler sehen so aus:
{ "error": { "code": "not_found", "message": "No scan with that id on this project." } }Die message sagt in einfachen Worten, was zu beheben ist.
Jeder Fehler und was zu tun ist
| Status und Code | Warum | Was zu tun ist |
|---|---|---|
401 unauthorized | Kein Schlüssel, ein vertippter oder widerrufener Schlüssel oder ein Token, das kein API-Schlüssel ist | Senden Sie Authorization: Bearer usk_live_... mit einem Schlüssel aus Projekteinstellungen, API-Schlüssel. Anmeldetokens der App und Connector-Schlüssel werden nicht akzeptiert |
403 forbidden | Die Person, die den Schlüssel erstellt hat, hat keine Inhaber- oder Vollzugriffsrechte mehr, oder das Konto hat keinen aktiven Tarif | Erstellen Sie als Inhaber oder Mitglied mit Vollzugriff einen neuen Schlüssel, oder wählen Sie unter Einstellungen, Abrechnung einen Tarif |
400 invalid_request | Ein Wert fehlt oder ist falsch, zum Beispiel eine Seite auf einer anderen Website oder zu viele Seiten | Lesen Sie message. Seiten-Scans müssen auf der Website des Projekts liegen; maxPages darf nicht höher sein, als Ihr Tarif erlaubt |
404 not_found | Kein solcher Scan, kein solches Problem und keine solche Lösungshilfe im Projekt dieses Schlüssels | Prüfen Sie die ID. Jeder Schlüssel sieht nur ein Projekt |
409 scan_running | Ein Scan dieser Art läuft bereits | Warten Sie, bis der in scanId genannte Scan fertig ist |
409 not_finished | Sie haben Ergebnisse angefordert, bevor der Scan fertig war | Warten Sie und fragen Sie dann erneut, oder nutzen Sie einen Webhook |
429 rate_limited | Mehr als 60 Anfragen pro Minute oder 10 Scan-Starts pro Stunde mit diesem Schlüssel | Warten Sie so viele Sekunden, wie im Header Retry-After stehen |
429 scan_limit_reached | Die Scans Ihres Tarifs für heute sind verbraucht, App und API zusammen | Warten Sie bis Mitternacht britischer Zeit (resetsAt) oder wechseln Sie zu einem größeren Tarif |
501 not_supported | Geplante Scans | Starten Sie Scans aus Ihrem eigenen Zeitplaner mit POST /scans |
500 server_error | Ein Fehler auf unserer Seite | Versuchen Sie es in Kürze erneut |
Was Sie außerdem prüfen sollten
- Aufruf von einer Seite im Browser: Die API funktioniert nur von einem Server aus. Browser werden abgelehnt, was Ihren Schlüssel zugleich vor fremden Blicken schützt.
- Ein Scan wurde neu gestartet: Wenn wir die App aktualisieren, während ein Website-Scan läuft, startet er unter einer neuen ID neu. Eine Anfrage mit der alten ID liefert den neuen Scan.
- Ihre kostenlose Testphase ist abgelaufen: Die API steht still, bis Sie einen Tarif wählen. Danach funktionieren Ihre Schlüssel sofort wieder.
Siehe die UtilitySEO-API und API-Webhooks.
Häufige Fragen
Jede Antwort hat X-RateLimit-Header. Was bedeuten sie?
X-RateLimit-Limit und X-RateLimit-Remaining zeigen, wie viele Anfragen der Schlüssel in der aktuellen Minute stellen darf und wie viele noch übrig sind.
Kann der Support sehen, warum meine Anfrage gescheitert ist?
Der Tab API-Schlüssel zeigt, wie viele Aufrufe die Schlüssel jedes Projekts gemacht haben. Für einen bestimmten Fehler schreiben Sie an support@utilityseo.com, mit der Uhrzeit, der Anfrage und dem code, den Sie bekommen haben.