Изпращане на грешки, без да се губи контекстът на искането.
{
"text": "Сложно изходно съдържание на избрания език.",
"locale": "bg",
"mode": "simple-language"
}Налични са примери за SDK и cURL
Единни съобщения за грешка
{
"error": {
"code": "invalid_request",
"message": "Check the request fields."
}
}Повечето грешки използват горната error структура. Отговорите за ограничение на заявките съдържат и полетата limit, remaining и reset на най-горно ниво.
{
"error": {
"code": "rate_limited",
"message": "Too many requests."
},
"limit": 1000,
"remaining": 0,
"reset": 1787836800
}При ограничение HTTP 429 изчакайте според хедъра Retry-After. allowance_exhausted вместо това съдържа error.details.used, limit и periodEndsAt.
Кодове за грешки
Тези кодове използват API версия 2:
| HTTP | Код | Значение | Действие на клиента |
|---|---|---|---|
| 400 | invalid_json | Основният текст на заявката не е валиден JSON | Коригирайте тялото на JSON |
| 400 | invalid_request | Полето липсва, не е известно или е невалидно, или текстът надхвърля 5 000 знака | Поправи искането |
| 400 | невалиден_ключ_идемпотентност | Заявка за задание или партида няма валиден ключ за идемпотентност | Изпратете уникален ключ от най-много 255 знака |
| 400 | невалидна_крайна_уебкукичка | Избраната крайна точка на webhook липсва или е неактивна | Изберете активна крайна точка или използвайте анкета |
| 401 | невалиден_api_ключ | Токенът на носителя липсва, невалиден е или е отменен | Проверете или сменете API ключа |
| 402 | billing_required | Фактурирането трябва да бъде актуализирано, преди обработката да може да продължи | Актуализирайте таксуването в приложението |
| 403 | feature_not_available | Работното пространство няма активни права | Изберете план или се свържете с поддръжката |
| 403 | email_not_verified | Няма потвърден имейл на собственик или администратор | Потвърдете отговарящ на условията имейл за акаунт |
| 404 | job_not_found | Заданието не съществува, принадлежи към друго работно пространство или е изтекло | Спрете запитването за статус и започнете нова поръчка, ако е необходимо |
| 404 | партида_не_намерена | Пакетът не съществува, принадлежи към друго работно пространство или е изтекъл | Спрете анкетирането и създайте нова партида, ако е необходимо |
| 429 | скорост_ограничена | Процентът на заявките е достигнат | Уважавайте след изпитание |
| 429 | concurrency_limit | Твърде много заявки се обработват едновременно | Опитайте отново, след като активната заявка приключи |
| 429 | allowance_exhausted | Месечният лимит за знаци е достигнат и допълнителното използване не е налично или е деактивирано | Изчакайте следващия период на фактуриране или активирайте допълнително използване на отговарящ на условията план |
| 502 | обработка_не успя | Услугата не можа да обработи текста | Повторете заявката и свържете се с поддръжката с идентификатора на искането, ако проблемът продължава. |
Документирайте за всяка грешка: може ли запитването да се повтори? Изчисляват ли знаци? Какво пише в протокола? Какви данни трябва подкрепата?