Αναφορά

Λάθη και όρια ποσοστών

Τα σφάλματα REST χρησιμοποιούν αυτόν τον φάκελο. Διατηρήστε το αναγνωριστικό αιτήματος για υποστήριξη και μην καταγράφετε ποτέ το κλειδί API σας:

Ξεκινήστε με κωδικό και requestId

Ο σταθερός κώδικας λέει στο πρόγραμμά σας τι συνέβη. Το αναγνώσιμο από τον άνθρωπο μήνυμα εξηγεί αυτό το αίτημα. Αποθηκεύστε το requestId όταν επικοινωνείτε με την υποστήριξη.

JSON error response

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "The API key is missing, invalid, or revoked.",
    "requestId": "req_..."
  }
}

Διορθώστε σφάλματα ελέγχου ταυτότητας και σχεδιασμού

Για το 401, ελέγξτε ότι η κεφαλίδα αρχίζει με Bearer ακολουθούμενη από ένα διάστημα και ένα ενεργό κλειδί. Για το 403, ελέγξτε το σχέδιο λογαριασμού και τα πεδία που επιλέχθηκαν κατά τη δημιουργία του κλειδιού.

Διορθώστε τα σφάλματα μεταφόρτωσης

Για το 409 ή το 422, επιβεβαιώστε ότι το PUT ολοκληρώθηκε, το περιεχόμενο-Τύπος αντιστοιχεί και ο αριθμός των μεταφορτωμένων byte ισούται με το μέγεθοςBytes. Δημιουργήστε μια νέα εργασία μεταφόρτωσης εάν έληξε η προσωρινή URL.

Κώδικας	HTTP	Εννοια
BAD_REQUEST	400 / 409	Το HTTP 400 σημαίνει ότι το σώμα του αιτήματος δεν είναι έγκυρο. Το HTTP 409 σημαίνει ότι η μεταφόρτωση δεν μπορεί να ολοκληρωθεί στην τρέχουσα κατάστασή της.
UNAUTHORIZED	401	Το κλειδί API λείπει, δεν είναι έγκυρο ή έχει ανακληθεί.
PAID_PLAN_REQUIRED	403	Ο λογαριασμός δεν διαθέτει κατάλληλο πρόγραμμα επί πληρωμή.
INSUFFICIENT_SCOPE	403	Το κλειδί API δεν περιλαμβάνει το απαιτούμενο εύρος.
NOT_FOUND	404	Η ιδιόκτητη μεταφόρτωση, το αρχείο ή η κοινή χρήση δεν βρέθηκε.
UPLOAD_NOT_READY	409	Το μεταφορτωμένο αντικείμενο δεν είναι έτοιμο για ολοκλήρωση.
FILE_TOO_LARGE	413	Το αρχείο υπερβαίνει το ισχύον όριο μεγέθους.
OBJECT_VALIDATION_FAILED	422	Η επικύρωση του μεταφορτωμένου αντικειμένου απέτυχε.
QUOTA_EXCEEDED	429	Το όριο μεταφόρτωσης έχει εξαντληθεί.
RATE_LIMIT_EXCEEDED	429	Ο ρυθμός αιτημάτων API έχει εξαντληθεί.
SERVICE_UNAVAILABLE	503	Μια απαιτούμενη υπηρεσία δεν είναι προσωρινά διαθέσιμη.

Κεφαλίδες ορίου ρυθμού

Δοκιμάστε ξανά το 429 μόνο μετά από Επανάληψη-Μετά. Δοκιμάστε ξανά προσωρινά σφάλματα 503 με εκθετική ανατροπή. Μην επαναλάβετε αυτόματα μη έγκυρα αιτήματα 400, 401 ή 403.