Изпращане на грешки, без да се губи контекстът на искането.
{
"text": "Сложно изходно съдържание на избрания език.",
"locale": "bg",
"mode": "simple-language"
}Налични са примери за SDK и cURL
Опасност
Производственият плик за грешка на версия 2 съдържа обект за грешка със стабилен код и полета за съобщения.
{
"error": {
"code": "invalid_request",
"message": "Check the request fields."
}
}Незадължителният детайлен обект носи машинно четим контекст като retryAfterSeconds.
Заглавките на HTTP отговора съдържат метаданни за удостоверяване и повторен опит, където е приложимо.
Каталог на грешките
Следните кодове са текущият договор за версия 2.
| HTTP | Код | Значение | Действие на клиента |
|---|---|---|---|
| 400 | invalid_json | Основният текст на заявката не е валиден JSON | Коригирайте тялото на JSON |
| 400 | invalid_request | Полето липсва, не е известно или е невалидно, или текстът надхвърля 10 000 знака | Поправи искането |
| 400 | невалиден_ключ_идемпотентност | Заявка за задание или партида няма валиден ключ за идемпотентност | Изпратете уникален ключ от най-много 255 знака |
| 400 | невалидна_крайна_уебкукичка | Избраната крайна точка на webhook липсва или е неактивна | Изберете активна крайна точка или използвайте анкета |
| 401 | невалиден_api_ключ | Токенът на носителя липсва, невалиден е или е отменен | Проверете или сменете API ключа |
| 402 | billing_required | Фактурирането трябва да бъде актуализирано, преди обработката да може да продължи | Актуализирайте таксуването в приложението |
| 403 | subscription_required | Работното пространство няма активни права | Изберете план или се свържете с поддръжката |
| 403 | email_not_verified | Няма потвърден имейл на собственик или администратор | Потвърдете отговарящ на условията имейл за акаунт |
| 404 | job_not_found | Заданието не съществува, принадлежи към друго работно пространство или е изтекло | Спрете анкетирането и създайте нова работа, ако е необходимо |
| 404 | партида_не_намерена | Пакетът не съществува, принадлежи към друго работно пространство или е изтекъл | Спрете анкетирането и създайте нова партида, ако е необходимо |
| 429 | скорост_ограничена | Процентът на заявките е достигнат | Уважавайте след изпитание |
| 429 | ограничение_на едновременност | Твърде много заявки се обработват едновременно | Опитайте отново, след като активната заявка приключи |
| 429 | надбавка_изчерпана | Месечният лимит за знаци е достигнат и допълнителното използване не е налично или е деактивирано | Изчакайте следващия период на фактуриране или активирайте допълнително използване на отговарящ на условията план |
| 502 | обработка_не успя | Услугата не можа да обработи текста | Опитайте отново безопасно и се свържете с поддръжката с ID на заявката, ако продължи |
За всяка грешка, възможност за повторен опит на документа, ефект от таксуването, видимост на регистрационния файл и информация за поддръжка.