Dokumente schützen
Laden Sie Text-, PDF- oder DOCX-Dateien hoch, verfolgen Sie den Auftrag und rufen Sie geschützte Artefakte ab.
Ablauf eines Dokumentauftrags
- Senden Sie rohe UTF-8-Text-, PDF- oder DOCX-Bytes an
POST /v1/documents/jobs. - Speichern Sie die zurückgegebene Auftrags-ID und fragen Sie folgenden Endpunkt ab:
GET /v1/documents/jobs/{id}. - Rufen Sie nach erfolgreichem Abschluss die aufgeführten Text-, PDF- und optionalen Zuordnungsartefakte ab.
- Löschen Sie temporäre Auftragsdaten oder lassen Sie sie ablaufen, nachdem Ihre Anwendung das benötigte Ergebnis gespeichert hat.
Der Inhaltstyp ist entscheidend
Senden Sie die Datei-Bytes direkt mit text/plain, application/pdfoder dem DOCX-Medientyp. Die maximale Uploadgröße beträgt 10 MB.
Datei senden
curl 'https://api.shinrai.innovius.io/v1/documents/jobs?mode=replace&include_mapping=true' \
-H "Authorization: Bearer $SHINRAI_API_KEY" \
-H 'Content-Type: application/pdf' \
-H 'Idempotency-Key: customer-case-4815' \
--data-binary @case.pdf
Status abfragen und Artefakte herunterladen
curl "https://api.shinrai.innovius.io/v1/documents/jobs/$JOB_ID" \
-H "Authorization: Bearer $SHINRAI_API_KEY"Verwenden Sie die Artefakt-URLs aus der Statusantwort. Auf Auftrag und Artefakte kann nur das Konto zugreifen, das den Auftrag erstellt hat.
Fehler sicher behandeln
Leiten Sie die Originaldatei bei fehlgeschlagenem Schutz nicht weiter. Behandeln Sie 415 als nicht unterstützten Medientyp, 422 als ungültigen Dokumentinhalt und 503 als vorübergehenden Worker-Fehler.