Σφάλματα και επαναλήψεις
Οι λάθη επιχειρήσεων επιστρέφουν τα 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 για διαγνωστικούς σκοπούς.
HTTP κατάσταση
Section titled “HTTP κατάσταση”| Κατάσταση | Σημασία | Συμβουλές |
|---|---|---|
400 | Άκυρη προσπάθεια, για παράδειγμα η επιλεγμένη ρύθμιση δεν είναι διαθέσιμη | Διορθώστε την αίτηση· μην επαναλάβετε την προσπάθεια |
401 | Λείπει, είναι άκυρο, έχει λήξει ή ανακληθεί το διαπιστευτήριο | Αλλάξτε το διαπιστευτήριο |
402 | Το υπόλοιπο (μετά την αποπληρωμή του χρέους) δεν υπερβαίνει το όριο θέσης εργασίας, ή είναι αρνητικό· με προσθήκη κλειδιού API, το υπόλοιπο προϋπολογισμού του κλειδιού μπορεί να είναι πολύ χαμηλό. | Αναπληρώστε (ή αυξήστε τον προϋπολογισμό του κλειδιού) και στη συνέχεια υποβάλετε ξανά |
403 | Τα όρια του κλειδιού δεν επιτρέπουν αυτήν τη λειτουργία (π.χ. η ρύθμιση μετάφρασης δεν επιτρέπεται), ο λογαριασμός είναι απενεργοποιημένος ή η λειτουργία πρέπει να εκτελεστεί σε προγράμματα περιήγησης με σύνδεση (όπως η διαχείριση κλειδιών API) | Ελέγξτε τις βασικές ρυθμίσεις ή χρησιμοποιήστε την ιστοσελίδα |
404 | Το στοιχείο δεν υπάρχει, έχει διαγραφεί ή ανήκει σε άλλο λογαριασμό (και τα τρία μοιάζουν ίδια) | Ελέγξτε τον κωδικό |
409 | Ο κλειδώρ ιδεμποτενσίας χρησιμοποιήθηκε για διαφορετικό αίτημα, ή η κατάσταση του πόρου δεν επιτρέπει τη λειτουργία | Ερωτήστε την αρχική λειτουργία και στη συνέχεια αποφασίστε |
410 | Ο πόρος ή το σημείο εισόδου έχει καταργηθεί οριστικά, για παράδειγμα ένα σημείο εισόδου που απενεργοποιήθηκε ή μια διαγραμμένη εργασία που συνδέεται με έναν παράγοντα ιδεμποτενσίας. | Μην επαναλάβετε την προσπάθεια |
413 | Το αρχείο ή το σώμα της αίτησης υπερβαίνει το όριο | Χρησιμοποιήστε ένα μικρότερο αρχείο |
415 | Μη υποστηριζόμενη μορφή αρχείου | Χρησιμοποιήστε άλλη μορφή |
422 | Η επικύρωση απέτυχε, ή το αρχείο είναι άδειο ή δεν περιέχει τίποτα για επεξεργασία | Διορθώστε τα πεδία· μην επαναλάβετε αυτόματα |
429 | Ποσόστωση, μέγεθος ουράς ή περιορισμός προϋπολογισμού | Δείτε παρακάτω |
5xx | Προσωρινό σφάλμα υπηρεσίας | Εκθετική αναβολή με μέγιστο αριθμό προσπαθειών |
Αντιμετώπιση 429
Section titled “Αντιμετώπιση 429”code | Σημασία | Τι να κάνετε |
|---|---|---|
RATE_LIMITED | Πάρα πολλές αιτήσεις | Περιμένετε το Retry-After, στη συνέχεια επαναλάβετε |
CONCURRENCY_LIMITED | Πάρα πολλές εργασίες μετάφρασης αρχείων βρίσκονται στην ουρά | Περιμένετε το Retry-After, ή να ολοκληρωθούν κάποιες εργασίες |
AUTH_API_KEY_QUOTA_EXCEEDED | Το όριο του κλειδιού έχει εξαντληθεί | Μην επαναλάβετε την προσπάθεια μέχρι να αυξηθεί το όριο προϋπολογισμού |
Ένας 429 χωρίς Retry-After πρέπει να διαχειρίζεται με εκθετική αναβολή.
Στρατηγική επανάληψης
Section titled “Στρατηγική επανάληψης”- Οι ερωτήσεις μπορούν να επαναληφθούν απευθείας.
- Όταν επαναλαμβάνετε μια αίτηση δημιουργίας, χρησιμοποιήστε ξανά το ίδιο
Idempotency-Keyκαι το ακριβώς ίδιο σώμα· χρησιμοποιήστε ένα νέο κλειδί για κάθε νέα υποβολή. - Μετά από μια αποτυχημένη ανάρτηση, ζητήστε μια νέα διεύθυνση ανάρτησης.
- Ορίστε χρόνους αναμονής σύνδεσης, ανάγνωσης και συνολικών για κάθε αίτημα, προσθέστε τυχαία διακύμανση στις επαναληπτικές προσπάθειες και ορίστε ανώτατο όριο στις προσπάθειες.
import randomimport 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())