跳转到内容

Ανέβασμα αρχείων

Η ανάρτηση γίνεται σε τρία βήματα: ζητήστε διεύθυνση ανάρτησης, στείλτε το αρχείο και επιβεβαιώστε το έγγραφο. Μία διεύθυνση ανάρτησης μπορεί να χρησιμοποιηθεί μία φορά και ισχύει για έως 1 ώρα.

1. Ζητήστε μια διεύθυνση ανέβασμα

Section titled “1. Ζητήστε μια διεύθυνση ανέβασμα”
POST /api/v1/upload/presign
X-API-Key: sk_your_key
Content-Type: application/json
{
"filename": "report.docx",
"file_size": 45678
}
ΠεδίοΤύποςΑπαιτούμενοΠεριγραφή
filenameσυμβολοσειρά✅Όνομα αρχείου· ο διακομιστής καθορίζει τον τύπο αρχείου από την επέκταση
file_sizeακέραιος✅Ακριβής μέγεθος σε μπάιτ, μεγαλύτερο από 0
mime_typeσυμβολοσειρά—Προαιρετικό· ο διακομιστής δεν το χρησιμοποιεί

Απάντηση:

{
"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
}

Στείλτε ένα PUT στο upload_url με τις ακατέργαστες μπάιτ του αρχείου ως το περιεχόμενο, και στείλτε κάθε πεδίο επικεφαλίδας στο upload_headers ακριβώς όπως δίνεται.

Terminal window
# UPLOAD_URL and UPLOAD_CONTENT_TYPE come from upload_url and upload_headers["Content-Type"] in the previous response
curl --fail-with-body -X PUT "$UPLOAD_URL" \
-H "Content-Type: $UPLOAD_CONTENT_TYPE" \
-H "If-None-Match: *" \
--upload-file "report.docx"

Μην στείλετε τον κωδικό API OmniDoc σας σε αυτό το βήμα. Εάν η διεύθυνση λήξει ή η μεταφορά αποτύχει, ζητήστε έναν νέο.

3. Επιβεβαιώστε το έγγραφο

Section titled “3. Επιβεβαιώστε το έγγραφο”
POST /api/v1/upload/finalize
X-API-Key: sk_your_key
Content-Type: application/json
{"finalize_token":"short_lived_token"}

Σε περίπτωση επιτυχίας, επιστρέφεται το έγγραφο:

{
"document": {
"id": "4q8mx2q9z1k7p6ra",
"basename": "report.docx",
"file_size": 45678,
"mime_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"created_at": "2026-10-01T12:00:00Z"
}
}

Μόνο μετά την επιβεβαίωση το έγγραφο εισάγεται στη βιβλιοθήκη αρχείων και γίνεται διαθέσιμο για χρήση σε έργα.

Το filename είναι μόνο για προβολή· μην το χρησιμοποιείτε ως διαδρομή ή μοναδικό αναγνωριστικό. Ο διακομιστής αντικαθιστά τους παράνομους χαρακτήρες και δημιουργεί ένα ασφαλές όνομα λήψης για ονόματα που είναι πολύ μακριά.

ΚατάστασηΑιτία
400Λάθος όνομα ή μέγεθος αρχείου, ή το μέγεθος που ανέβηκε διαφέρει από αυτό που ζητήθηκε
401Πιστοποιητικό ή finalize_token άκυρο ή λήξαν
403Το finalize_token ανήκει σε άλλο λογαριασμό
410Το ανεβασμένο αρχείο δεν βρέθηκε (η μεταφορά είναι ελλιπής ή η διεύθυνση έχει λήξει); ζητήστε μια νέα διεύθυνση
413Υπερβαίνει το όριο μεγέθους ανά αρχείο
415Απροσυνάρτηση μορφή, ή το περιεχόμενο δεν ταιριάζει με την επέκταση
422Το αρχείο Office είναι κατεστραμμένο ή δομικά ασφαλές
429Πάρα πολλές ανεβάσματα
503Η υπηρεσία ανέβασματος είναι προσωρινά μη διαθέσιμη· προσπαθήστε ξανά αργότερα