Ανέβασμα αρχείων
Η ανάρτηση γίνεται σε τρία βήματα: ζητήστε διεύθυνση ανάρτησης, στείλτε το αρχείο και επιβεβαιώστε το έγγραφο. Μία διεύθυνση ανάρτησης μπορεί να χρησιμοποιηθεί μία φορά και ισχύει για έως 1 ώρα.
1. Ζητήστε μια διεύθυνση ανέβασμα
Section titled “1. Ζητήστε μια διεύθυνση ανέβασμα”POST /api/v1/upload/presignX-API-Key: sk_your_keyContent-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}2. Στείλτε το αρχείο
Section titled “2. Στείλτε το αρχείο”Στείλτε ένα PUT στο upload_url με τις ακατέργαστες μπάιτ του αρχείου ως το περιεχόμενο, και στείλτε κάθε πεδίο επικεφαλίδας στο upload_headers ακριβώς όπως δίνεται.
# 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"Μην στείλετε τον κωδικό API OmniDoc σας σε αυτό το βήμα. Εάν η διεύθυνση λήξει ή η μεταφορά αποτύχει, ζητήστε έναν νέο.
3. Επιβεβαιώστε το έγγραφο
Section titled “3. Επιβεβαιώστε το έγγραφο”POST /api/v1/upload/finalizeX-API-Key: sk_your_keyContent-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" }}Μόνο μετά την επιβεβαίωση το έγγραφο εισάγεται στη βιβλιοθήκη αρχείων και γίνεται διαθέσιμο για χρήση σε έργα.
Ονόματα αρχείων
Section titled “Ονόματα αρχείων”Το filename είναι μόνο για προβολή· μην το χρησιμοποιείτε ως διαδρομή ή μοναδικό αναγνωριστικό. Ο διακομιστής αντικαθιστά τους παράνομους χαρακτήρες και δημιουργεί ένα ασφαλές όνομα λήψης για ονόματα που είναι πολύ μακριά.
Σφάλματα
Section titled “Σφάλματα”| Κατάσταση | Αιτία |
|---|---|
400 | Λάθος όνομα ή μέγεθος αρχείου, ή το μέγεθος που ανέβηκε διαφέρει από αυτό που ζητήθηκε |
401 | Πιστοποιητικό ή finalize_token άκυρο ή λήξαν |
403 | Το finalize_token ανήκει σε άλλο λογαριασμό |
410 | Το ανεβασμένο αρχείο δεν βρέθηκε (η μεταφορά είναι ελλιπής ή η διεύθυνση έχει λήξει); ζητήστε μια νέα διεύθυνση |
413 | Υπερβαίνει το όριο μεγέθους ανά αρχείο |
415 | Απροσυνάρτηση μορφή, ή το περιεχόμενο δεν ταιριάζει με την επέκταση |
422 | Το αρχείο Office είναι κατεστραμμένο ή δομικά ασφαλές |
429 | Πάρα πολλές ανεβάσματα |
503 | Η υπηρεσία ανέβασματος είναι προσωρινά μη διαθέσιμη· προσπαθήστε ξανά αργότερα |