跳转到内容

Σφάλματα και επαναλήψεις

Οι λάθη επιχειρήσεων επιστρέφουν τα code και message στο ανώτατο επίπεδο του σώματος απόκρισης. Το detail είναι συνήθως ίδιο με το message, αλλά μπορεί να είναι μια διαφορετική, συντομότερη εξήγηση (όπως παρακάτω); εμφανίστε το message στους χρήστες. Τα μηνύματα είναι στα κινεζικά:

{
"code": "CONCURRENCY_LIMITED",
"message": "排队中的文件已达上限(1000 个),请等部分文件翻译完成后再提交",
"detail": "排队文件完成一部分后可继续提交"
}

Μερικά λάθη επιχειρήσεων επιστρέφουν μόνο το code. Οι σφάλματα επικύρωσης επιστρέφουν το 422 με μια λίστα σφαλμάτων πεδίου στο detail:

{
"detail": [
{ "loc": ["body", "target_lang"], "msg": "Field required", "type": "missing" }
]
}

Αντιμετωπίστε τα σφάλματα πρώτα με τον κωδικό HTTP και στη συνέχεια με τον code: πολλά σφάλματα επιστρέφουν μόνο το γενικό UNKNOWN_ERROR, και μόνο ορισμένα φέρουν έναν συγκεκριμένο code (όπως οι 429 περιπτώσεις παρακάτω). Καταχωρήστε τον επιστρεφόμενο αριθμό πρωτοκόλλου X-Request-Id για διαγνωστικούς σκοπούς.

ΚατάστασηΣημασίαΣυμβουλές
400Άκυρη προσπάθεια, για παράδειγμα η επιλεγμένη ρύθμιση δεν είναι διαθέσιμηΔιορθώστε την αίτηση· μην επαναλάβετε την προσπάθεια
401Λείπει, είναι άκυρο, έχει λήξει ή ανακληθεί το διαπιστευτήριοΑλλάξτε το διαπιστευτήριο
402Το υπόλοιπο (μετά την αποπληρωμή του χρέους) δεν υπερβαίνει το όριο θέσης εργασίας, ή είναι αρνητικό· με προσθήκη κλειδιού API, το υπόλοιπο προϋπολογισμού του κλειδιού μπορεί να είναι πολύ χαμηλό.Αναπληρώστε (ή αυξήστε τον προϋπολογισμό του κλειδιού) και στη συνέχεια υποβάλετε ξανά
403Τα όρια του κλειδιού δεν επιτρέπουν αυτήν τη λειτουργία (π.χ. η ρύθμιση μετάφρασης δεν επιτρέπεται), ο λογαριασμός είναι απενεργοποιημένος ή η λειτουργία πρέπει να εκτελεστεί σε προγράμματα περιήγησης με σύνδεση (όπως η διαχείριση κλειδιών API)Ελέγξτε τις βασικές ρυθμίσεις ή χρησιμοποιήστε την ιστοσελίδα
404Το στοιχείο δεν υπάρχει, έχει διαγραφεί ή ανήκει σε άλλο λογαριασμό (και τα τρία μοιάζουν ίδια)Ελέγξτε τον κωδικό
409Ο κλειδώρ ιδεμποτενσίας χρησιμοποιήθηκε για διαφορετικό αίτημα, ή η κατάσταση του πόρου δεν επιτρέπει τη λειτουργίαΕρωτήστε την αρχική λειτουργία και στη συνέχεια αποφασίστε
410Ο πόρος ή το σημείο εισόδου έχει καταργηθεί οριστικά, για παράδειγμα ένα σημείο εισόδου που απενεργοποιήθηκε ή μια διαγραμμένη εργασία που συνδέεται με έναν παράγοντα ιδεμποτενσίας.Μην επαναλάβετε την προσπάθεια
413Το αρχείο ή το σώμα της αίτησης υπερβαίνει το όριοΧρησιμοποιήστε ένα μικρότερο αρχείο
415Μη υποστηριζόμενη μορφή αρχείουΧρησιμοποιήστε άλλη μορφή
422Η επικύρωση απέτυχε, ή το αρχείο είναι άδειο ή δεν περιέχει τίποτα για επεξεργασίαΔιορθώστε τα πεδία· μην επαναλάβετε αυτόματα
429Ποσόστωση, μέγεθος ουράς ή περιορισμός προϋπολογισμούΔείτε παρακάτω
5xxΠροσωρινό σφάλμα υπηρεσίαςΕκθετική αναβολή με μέγιστο αριθμό προσπαθειών
codeΣημασίαΤι να κάνετε
RATE_LIMITEDΠάρα πολλές αιτήσειςΠεριμένετε το Retry-After, στη συνέχεια επαναλάβετε
CONCURRENCY_LIMITEDΠάρα πολλές εργασίες μετάφρασης αρχείων βρίσκονται στην ουράΠεριμένετε το Retry-After, ή να ολοκληρωθούν κάποιες εργασίες
AUTH_API_KEY_QUOTA_EXCEEDEDΤο όριο του κλειδιού έχει εξαντληθείΜην επαναλάβετε την προσπάθεια μέχρι να αυξηθεί το όριο προϋπολογισμού

Ένας 429 χωρίς Retry-After πρέπει να διαχειρίζεται με εκθετική αναβολή.

  • Οι ερωτήσεις μπορούν να επαναληφθούν απευθείας.
  • Όταν επαναλαμβάνετε μια αίτηση δημιουργίας, χρησιμοποιήστε ξανά το ίδιο Idempotency-Key και το ακριβώς ίδιο σώμα· χρησιμοποιήστε ένα νέο κλειδί για κάθε νέα υποβολή.
  • Μετά από μια αποτυχημένη ανάρτηση, ζητήστε μια νέα διεύθυνση ανάρτησης.
  • Ορίστε χρόνους αναμονής σύνδεσης, ανάγνωσης και συνολικών για κάθε αίτημα, προσθέστε τυχαία διακύμανση στις επαναληπτικές προσπάθειες και ορίστε ανώτατο όριο στις προσπάθειες.
import random
import time
for attempt in range(5):
response = call_api()
if response.status_code not in {429, 500, 502, 503, 504}:
break
if response.status_code == 429 and response.json().get("code") == "AUTH_API_KEY_QUOTA_EXCEEDED":
break
retry_after = response.headers.get("Retry-After")
delay = float(retry_after) if retry_after else min(2 ** attempt, 16)
time.sleep(delay + random.random())