Қателер және қайта тырнау
Бизнес қателіктері жауап денесінің жоғарғы деңгейінде code және message мәндерін қайтарады. detail әдетте message мәнімен бірдей болады, бірақ төмендегідей әртүрлі, қысқа түсіндіру болуы мүмкін; пайдаланушыларға message мәнін көрсетіңіз. Хабарламалар қытай тілінде:
{ "code": "CONCURRENCY_LIMITED", "message": "排队中的文件已达上限(1000 个),请等部分文件翻译完成后再提交", "detail": "排队文件完成一部分后可继续提交"}Кейбір бизнес қателіктері тек code мәнін қайтарады. Валидация сәтсіздіктері detail форматындағы өріс қателіктерінің тізімімен 422 мәнін қайтарады:
{ "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 | Ресурс жоқ немесе жойылған не басқа аккаунтқа тиесілі (үшеуі де бірдей көрінеді) | ID-ді тексеріңіз |
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 | Кілттің бюджеті таусылды | Бюджет көтерілмейінше қайта тырыспаңыз |
Retry-After жоқ 429 экспоненциалды кейінге қалдыру арқылы өңделуі тиіс.
Қайта тырысу стратегиясы
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())