Uprawnienie błędów bez utraty kontekstu żądania.
{
"text": "Kompleksowa treść źródłowa w wybranym języku.",
"locale": "pl",
"mode": "simple-language"
}Dostępne przykłady SDK i cURL
Jednolite komunikaty błędów
{
"error": {
"code": "invalid_request",
"message": "Check the request fields."
}
}Większość błędów używa powyższej struktury error. Odpowiedzi o ograniczeniu szybkości zawierają również pola najwyższego poziomu limit, remaining i reset.
{
"error": {
"code": "rate_limited",
"message": "Too many requests."
},
"limit": 1000,
"remaining": 0,
"reset": 1787836800
}W przypadku ograniczenia szybkości HTTP 429 odczekaj zgodnie z nagłówkiem Retry-After. allowance_exhausted zawiera zamiast tego error.details.used, limit i periodEndsAt.
Kody błędów
Te kody błędów używają API w wersji 2:
| HTTP | Kod | Znaczenie | Działanie klienta |
|---|---|---|---|
| 400 | nieprawidłowy_json | Treść żądania nie jest prawidłowym formatem JSON | Popraw treść JSON |
| 400 | invalid_request | Brakuje pola, jest nieznane lub nieprawidłowe albo tekst przekracza 5 000 znaków | Popraw wniosek |
| 400 | nieprawidłowy_idempotency_key | Zadanie lub żądanie wsadowe nie ma prawidłowego klucza Idempotency | Wyślij unikalny klucz składający się maksymalnie z 255 znaków |
| 400 | nieprawidłowy_punkt końcowy_webhooka | Brakuje wybranego punktu końcowego webhooka lub jest on nieaktywny | Wybierz aktywny punkt końcowy lub użyj odpytywania |
| 401 | nieprawidłowy_klucz_api | Brakuje tokenu okaziciela, jest on nieprawidłowy lub został unieważniony | Sprawdź lub wymień klucz API |
| 402 | wymagane_rozliczenia | Aby móc kontynuować przetwarzanie, należy zaktualizować rozliczenia | Zaktualizuj rozliczenia w aplikacji |
| 403 | wymagane subskrypcje | Obszar roboczy nie ma aktywnego uprawnienia | Wybierz plan lub skontaktuj się z pomocą techniczną |
| 403 | email_not_verified | Żaden adres e-mail właściciela ani administratora nie został zweryfikowany | Zweryfikuj kwalifikujący się adres e-mail konta |
| 404 | praca_nie_znaleziona | Zadanie nie istnieje, należy do innego obszaru roboczego lub wygasło | Zatrzymaj zapytanie o status i w razie potrzeby uruchom nowe zamówienie |
| 404 | partia_nie_znaleziona | Partia nie istnieje, należy do innego obszaru roboczego lub wygasła | Zatrzymaj odpytywanie i w razie potrzeby utwórz nową partię |
| 429 | stawka_ograniczona | Osiągnięto liczbę żądań | Uważajcie się po próbie |
| 429 | Limit wymiany walut | Jednocześnie przetwarzanych jest zbyt wiele żądań | Spróbuj ponownie po zakończeniu aktywnego żądania |
| 429 | dodatek wyczerpany | Osiągnięto miesięczny limit znaków i dodatkowe możliwości są niedostępne lub wyłączone | Poczekaj na następny okres rozliczeniowy lub włącz dodatkowe wykorzystanie w ramach kwalifikującego się planu |
| 502 | processing_failed | Usługa nie mogła przetworzyć tekstu | Ponów żądanie, a jeśli problem nadal występuje, skontaktuj się z pomocą techniczną |
Dokument dla każdego błędu: Czy można powtórzyć wniosek? Czy objawy są obliczone? Co jest w protokole? Jakich informacji potrzebuje wsparcie?