Dateien hochladen
Das Hochladen erfolgt in drei Schritten: Anforderung einer Upload-Adresse, Senden der Datei und Bestätigung des Dokuments. Eine Upload-Adresse kann einmalig angefordert werden und ist bis zu 1 Stunde gültig.
1. Eine Upload-Adresse anfordern
Abschnitt betitelt „1. Eine Upload-Adresse anfordern“POST /api/v1/upload/presignX-API-Key: sk_your_keyContent-Type: application/json{ "filename": "report.docx", "file_size": 45678}| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
filename | Zeichenfolge | ✅ | Dateiname; der Server ermittelt den Dateityp anhand der Erweiterung |
file_size | Ganzzahl | ✅ | Genauer Wert in Byte, größer als 0 |
mime_type | Zeichenfolge | — | Optional; der Server verwendet es nicht |
Antwort:
{ "document_id": "4q8mx2q9z1k7p6ra", "upload_url": "https://upload.example/...", "upload_headers": { "Content-Type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "If-None-Match": "*" }, "finalize_token": "short_lived_token", "expires_in": 3600}2. Senden Sie die Datei
Abschnitt betitelt „2. Senden Sie die Datei“Senden Sie eine PUT an upload_url mit den Rohdatei-Bytes als Nachrichtentext und übermitteln Sie jeden Header in upload_headers exakt wie angegeben.
# UPLOAD_URL and UPLOAD_CONTENT_TYPE come from upload_url and upload_headers["Content-Type"] in the previous responsecurl --fail-with-body -X PUT "$UPLOAD_URL" \ -H "Content-Type: $UPLOAD_CONTENT_TYPE" \ -H "If-None-Match: *" \ --upload-file "report.docx"Senden Sie in diesem Schritt nicht Ihren OmniDoc API-Schlüssel. Wenn die Adresse abläuft oder die Überweisung fehlschlägt, beantragen Sie einen neuen.
3. Dokument bestätigen
Abschnitt betitelt „3. Dokument bestätigen“POST /api/v1/upload/finalizeX-API-Key: sk_your_keyContent-Type: application/json{"finalize_token":"short_lived_token"}Bei Erfolg wird das Dokument zurückgegeben:
{ "document": { "id": "4q8mx2q9z1k7p6ra", "basename": "report.docx", "file_size": 45678, "mime_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "created_at": "2026-10-01T12:00:00Z" }}Erst nach der Bestätigung wird das Dokument in die Dateibibliothek übernommen und für Aufträge nutzbar.
Dateinamen
Abschnitt betitelt „Dateinamen“filename dient ausschließlich der Anzeige; verwenden Sie es nicht als Pfad oder eindeutige Kennung. Der Server ersetzt ungültige Zeichen und erzeugt einen sicheren Downloadnamen für zu lange Namen.
| Status | Ursache |
|---|---|
400 | Ungültiger Dateiname oder -größe, oder die hochgeladene Größe weicht von der angeforderten ab. |
401 | Anmeldeinformation oder finalize_token ungültig oder abgelaufen |
403 | Das finalize_token gehört einem anderen Konto |
410 | Die hochgeladene Datei wurde nicht gefunden (Übertragung unvollständig oder Adresse abgelaufen); bitte fordern Sie eine neue Adresse an. |
413 | Überschreitet das Größenlimit pro Datei |
415 | Nicht unterstütztes Format oder der Inhalt stimmt nicht mit der Erweiterung überein. |
422 | Die Datei Office ist beschädigt oder strukturell unsicher. |
429 | Zu viele Uploads |
503 | Der Upload-Dienst ist vorübergehend nicht verfügbar; bitte versuchen Sie es später erneut. |