Hosting-API: 401, 403, 429, Timeout und unbekannter Jobstatus beheben
Wenn ein API-Aufruf scheitert oder ein Job nicht eindeutig endet, prüfe zuerst HTTP-Status, error.code, meta.request_id und gegebenenfalls Retry-After. 503 bedeutet, dass die API oder ein Backend derzeit nicht verfügbar ist; ist die API für dein Konto nicht aktiviert, antwortet sie mit 403 und dem Code account_not_enabled.
Symptome und Maßnahmen
| Beobachtung | Prüfe | Nächster Schritt |
|---|---|---|
401 |
Bearer-Token, Ablauf, Widerruf, Benutzerzuordnung | neues Token mit passenden Zielen ausstellen; Secret nie an Support senden |
403 |
aktuelle Benutzerrechte und Token-Permission; Code account_not_enabled = API für das Konto nicht aktiviert |
Rechte korrigieren oder neues Token ausstellen; bei account_not_enabled den Support kontaktieren |
404 |
site_id/Operation-ID und aktuelle Zielzuordnung |
Site erneut über GET /sites ermitteln; fremde Ziele bleiben verborgen |
409 |
gleicher Idempotency-Key mit anderer Nutzlast oder parallele Site-Mutation | vorhandenen Auftrag lesen; keine neue Mutation blind starten |
413/415 |
Größenlimit bzw. fehlender JSON-Content-Type |
Datei verkleinern bzw. Content-Type: application/json senden |
422 |
Site-Typ und Fähigkeiten; bei der synchronen Preview blockierende Prüfbefunde (blocking); eine blockierte Veröffentlichung ergibt stattdessen einen Job mit Status unknown/Code blocking |
nur passende Aktion ausführen, etwa static:deploy für AI Launch; bei blocking den Prüfbericht der Website beheben und die Live-Version prüfen |
429 |
Requests, neue Writes, parallele Jobs und Tageslimits | Retry-After beachten; Polling reduzieren |
502/503 |
Backend-/API-Verfügbarkeit | vorhandenen Jobstatus prüfen, Request-ID an Support geben |
Timeout oder unknown
Ein Timeout beweist weder Erfolg noch Fehlschlag. Wenn du eine Operations-ID hast, frage genau diesen Job ab. Sonst wiederhole innerhalb von 24 Stunden nur denselben Request mit demselben Idempotency-Key und exakt derselben Nutzlast. Nach Ablauf des Fensters kann selbst derselbe Key eine zweite Wirkung auslösen. unknown bedeutet: Pipeline stoppen, Backendzustand manuell klären, keine automatische Wiederholung mit neuem Key.
Deployment fehlgeschlagen
Prüfe zunächst den Jobstatus. Nach Codeübertragung einen HTTP-Smoke-Test ausführen. Bei Fehlanzeige kann eine frühere Codeversion zurückgeschaltet werden; ein Rollback setzt keine Datenbankänderung zurück. Bei WordPress nie Datenbank, Uploads, wp-config.php oder Core aus einer CI-Kopie über das Live-System schreiben.
Wenn das Problem bleibt
Sende dem Support meta.request_id, Zeitpunkt, HTTP-Methode, Route ohne Query-Secrets und den Status/Fehlercode. Kein Token, SSH-Key, vollständiger Requestbody oder CI-Log mit Secrets mitschicken. Siehe Tokenverwaltung und OpenAPI-Referenz.