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
Okładka błędu
Koperta błędu produkcyjnego wersji 2 zawiera obiekt błędu ze stabilnym kodem i polami komunikatu.
{
"error": {
"code": "invalid_request",
"message": "Check the request fields."
}
}Opcjonalny obiekt szczegółów zawiera kontekst czytelny dla maszyny, taki jak retryAfterSeconds.
Nagłówki odpowiedzi HTTP zawierają metadane dotyczące uwierzytelniania i ponawiania prób, jeśli ma to zastosowanie.
Wymaga się katalogu błędów
Poniższe kody stanowią aktualną umowę 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 10 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 | wymagana_subskrypcja | 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 odpytywanie i w razie potrzeby utwórz nowe zadanie |
| 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_współbieżności | Jednocześnie przetwarzanych jest zbyt wiele żądań | Spróbuj ponownie po zakończeniu aktywnego żądania |
| 429 | zasiłek_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 | Spróbuj ponownie bezpiecznie i skontaktuj się z pomocą techniczną, podając identyfikator żądania, jeśli będzie się powtarzać |
Dla każdego błędu, możliwości ponownej próby dokumentu, efektu rozliczeniowego, widoczności dziennika i informacji o pomocy technicznej.