Zum Hauptinhalt springen

tool_unavailable

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

Der Dienst, der die Arbeit von /pdf/split, /pdf/compress und /pdf/to-image erledigt, ist gerade ausgelastet oder nicht erreichbar. Formfeed hat es innerhalb der 60 Sekunden, die ein Aufruf hat, bereits erneut versucht. Die Antwort trägt Retry-After (5 Sekunden) und die render_id des gescheiterten Aufrufs, der im Render-Log erscheint. Es wurde nichts berechnet.

Beispiel​

{
  "type": "https://docs.formfeed.dev/errors/tool-unavailable",
  "title": "PDF tools unavailable",
  "status": 503,
  "detail": "The PDF tools are busy; retry shortly",
  "code": "tool_unavailable",
  "render_id": "rnd_0d290c45cbeb4554b946bbad1acee87e",
  "request_id": "req_4b7c1e9a2f3d4c5b8a6e7f9012"
}

Häufige Ursachen​

  • Viele gleichzeitige Aufrufe der Tools und Office-Umwandlungen in Ihrer Region: Beide teilen sich einen Dienst, daher stauen sich Spitzen.
  • Der Dienst startet nach einem Update neu (The PDF tools are not reachable; retry shortly).

So beheben Sie es​

  • Wiederholen Sie nach der Anzahl Sekunden im Header Retry-After, mit demselben Idempotency-Key.
  • Verteilen Sie große Mengen an Aufrufen über die Zeit.

Wiederholen?​

Ja, nach den Sekunden aus Retry-After, mit demselben Idempotency-Key; Antworten 503 werden nicht unter dem Schlüssel gespeichert.