Zum Hauptinhalt springen

source_invalid

HTTP 422 · code: "source_invalid" · type: https://docs.formfeed.dev/errors/source-invalid

Eine Quelle existiert, lässt sich aber nicht verarbeiten: Das Rendering war nicht erfolgreich, die Datei hat nicht die Art, die der Schritt braucht, oder sie lässt sich nicht lesen. Zusammenführen, Schützen, Wasserzeichen und post.merge_after brauchen PDFs; ein Bild-Wasserzeichen braucht ein PNG oder JPEG; /pdf/convert mit einer Rendering-ID braucht eine Word- oder PowerPoint-Ausgabe. field, index und render_id sagen, welche Quelle, wo das Gateway das Problem gefunden hat. Es wurde nichts berechnet.

Beispiel​

{
  "type": "https://docs.formfeed.dev/errors/source-invalid",
  "title": "Source cannot be processed",
  "status": 422,
  "detail": "Render rnd_7da09ab6cd9946b798c187c2a9350852 is failed; only succeeded renders can be processed",
  "code": "source_invalid",
  "field": "source",
  "index": 0,
  "render_id": "rnd_7da09ab6cd9946b798c187c2a9350852",
  "request_id": "req_4b7c1e9a2f3d4c5b8a6e7f9012"
}

Häufige Ursachen​

  • Das Quell-Rendering ist fehlgeschlagen oder noch queued oder rendering.
  • Das Quell-Rendering hat ein Bild erzeugt, kein PDF (Render … produced png, not a PDF), oder eine Datei der Bibliothek ist kein PDF.
  • Ein Wasserzeichen-image, das kein PNG oder JPEG ist oder sich nicht lesen lässt.
  • Ein PDF, das sich nicht lesen lässt, etwa eine beschädigte Datei in der Bibliothek (terms.pdf is not a readable PDF).
  • /pdf/convert mit einem Rendering, dessen Ausgabe kein Word- oder PowerPoint-Dokument ist; PDFs und Bilder brauchen keine Umwandlung.
  • Ein Office-Dokument, das LibreOffice nicht lesen will (The document cannot be converted, mit dem reason des Konverters).

So beheben Sie es​

  • Warten Sie, bis das Quell-Rendering status: "succeeded" hat (fragen Sie es ab, oder warten Sie auf seinen Webhook render.completed), und rufen Sie dann das Tool auf.
  • Verwenden Sie für Zusammenführen, Schützen und Wasserzeichen PDF-Ausgaben und PDF-Dateien der Bibliothek, und für ein Bild-Wasserzeichen PNG- oder JPEG-Dateien.
  • Öffnen Sie ein PDF, das sich nicht lesen lässt, in einem Viewer, speichern oder exportieren Sie es erneut und laden Sie es neu hoch.

Wiederholen?​

Erst, wenn sich die Quelle geändert hat, etwa wenn das Quell-Rendering fertig ist. Senden Sie die Anfrage dann mit einem neuen Idempotency-Key oder ohne: Eine 4xx-Antwort wird 24 Stunden unter ihrem Schlüssel gespeichert, der alte Schlüssel liefert also wieder dieses Problem. Siehe Wiederholen.