跳转到内容

Қателер және қайта тырнау

Бизнес қателіктері жауап денесінің жоғарғы деңгейінде 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 жауап басылымын жазып алыңыз.

МәртебеМәніКеңес
400Жарамсыз сұраным, мысалы, таңдалған параметр қолжетімсізСұранымды түзетіңіз; қайта тырыспаңыз
401Куәлік жоқ, жарамсыз, мерзімі өткен немесе күшін жойғанАутентификация деректерін өзгертіңіз
402Баланс (қарыздан кейінгі) жұмыс шегінен жоғары емес немесе теріс; API кілті болған жағдайда, кілттің қалдық бюджеті тым төмен болуы мүмкін.Толықтырыңыз (немесе кілттің бюджетін арттырыңыз), содан кейін қайта жіберіңіз
403Кілт шектеулері бұл операцияны жүзеге асыруға мүмкіндік бермейді (мысалы, аударма параметрі қолданылмайды), есептік жазба өшірілген немесе операция кіруге рұқсат етілген браузерде жүзеге асырылуы тиіс (мысалы, API кілттерін басқару).Кілт параметрлерін тексеріңіз немесе веб-сайтты пайдаланыңыз
404Ресурс жоқ немесе жойылған не басқа аккаунтқа тиесілі (үшеуі де бірдей көрінеді)ID-ді тексеріңіз
409Идемпотенттік кілт басқа сұрауға пайдаланылды немесе ресурстың күйі операцияны жүзеге асыруға мүмкіндік бермейдіБастапқы операцияны сұраңыз, содан кейін шешім қабылдаңыз
410Ресурс немесе нүкте мәңгі жойылды, мысалы, қолданыстан шығарылған нүкте немесе идемпотенттік кілт арқылы жойылған тапсырма.Қайта тырыспаңыз
413Файл немесе сұраным денесі шекті мәннен асып кеттіШағын файлды пайдаланыңыз
415Қолдаусыз файл пішіміБасқа форматты пайдаланыңыз
422Валидация сәтсіз аяқталды немесе файл бос немесе өңделетін дерек жоқӨрістерді түзетіңіз; автоматты түрде қайта тырыспаңыз
429Жылдамдық, кезектің ұзындығы немесе бюджет шектелгенТөменде қараңыз
5xxУақытша қызмет қатесіМаксималды қайталау саны бар экспоненциалды кешіктіру
codeМәніНе істеу керек
RATE_LIMITEDСұраныстар тым көпRetry-After жүктегенше күтіңіз, содан кейін қайта тырысыңыз
CONCURRENCY_LIMITEDФайлды аудару жұмыстарының тізімінде тым көп тапсырыс барRetry-After жүктелгенше немесе кейбір тапсырмалар аяқталғанша күтіңіз
AUTH_API_KEY_QUOTA_EXCEEDEDКілттің бюджеті таусылдыБюджет көтерілмейінше қайта тырыспаңыз

Retry-After жоқ 429 экспоненциалды кейінге қалдыру арқылы өңделуі тиіс.

Қайта тырысу стратегиясы

Section titled “Қайта тырысу стратегиясы”
  • Сұрауларды тікелей қайта тыңдауға болады.
  • Жаңадан жасау сұранымын қайта тырысқанда, бірдей 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())