Zum Hauptinhalt springen

office_unavailable

HTTP 503 · code: "office_unavailable" · type: https://docs.formfeed.dev/errors/office-unavailable

Der Konverter, der Word-, Excel- und PowerPoint-Dokumente in PDFs umwandelt, ist gerade ausgelastet oder nicht erreichbar. Formfeed hat es innerhalb der 60 Sekunden, die eine Umwandlung hat, bereits erneut versucht. Die Antwort trägt Retry-After (5 Sekunden). Das passiert bei /pdf/convert und wenn eine Word- oder PowerPoint-Vorlage gerendert wird. Es wurde nichts berechnet.

Beispiel​

{
  "type": "https://docs.formfeed.dev/errors/office-unavailable",
  "title": "Office conversion unavailable",
  "status": 503,
  "detail": "The office converter is busy; retry shortly",
  "code": "office_unavailable",
  "request_id": "req_4b7c1e9a2f3d4c5b8a6e7f9012"
}

Ein synchrones Rendering einer Vorlage trägt zusätzlich seine render_id.

Häufige Ursachen​

  • Viele gleichzeitige Umwandlungen in Ihrer Region. Jedes Dokument wird einzeln umgewandelt, daher stauen sich Spitzen.
  • Der Konverter startet nach einem Update neu (The office converter is not reachable; retry shortly).
  • Eine Word- oder PowerPoint-Vorlage mit WebP-, GIF- oder AVIF-Bildern, die der Browser zeichnen muss, als kein Browser-Platz frei war (No browser slot was free to draw the document's pictures).

So beheben Sie es​

  • Wiederholen Sie nach der Anzahl Sekunden im Header Retry-After, mit demselben Idempotency-Key.
  • Verteilen Sie große Mengen an Umwandlungen über die Zeit, oder senden Sie Renderings von Vorlagen asynchron oder als Batch: Die Warteschlange wiederholt diesen Fehler selbst, 5 und dann 10 Sekunden später. Scheitern alle drei Versuche, endet das Rendering als worker_exhausted mit dieser Meldung.

Wiederholen?​

Ja, nach den Sekunden aus Retry-After, mit demselben Idempotency-Key; Antworten 503 werden nicht unter dem Schlüssel gespeichert. Die SDKs erledigen das für Sie.