Odniesienie

Błędy i limity szybkości

Błędy REST wykorzystują tę obwiednię. Zachowaj identyfikator żądania pomocy i nigdy nie rejestruj klucza API:

Zacznij od kodu i identyfikatora żądania

Stabilny kod informuje program, co się stało. Wiadomość czytelna dla człowieka wyjaśnia tę prośbę. Zapisz identyfikator żądania podczas kontaktowania się z pomocą techniczną.

JSON error response

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "The API key is missing, invalid, or revoked.",
    "requestId": "req_..."
  }
}

Napraw błędy uwierzytelniania i planu

W przypadku numeru 401 sprawdź, czy nagłówek zaczyna się od Bearer, po którym następuje jedna spacja i aktywny klucz. W przypadku 403 sprawdź plan konta i zakresy wybrane podczas tworzenia klucza.

Napraw błędy stanu przesyłania

W przypadku 409 lub 422 potwierdź zakończenie PUT, dopasowanie typu zawartości i liczbę przesłanych bajtów równą sizeBytes. Utwórz nowe zadanie przesyłania, jeśli tymczasowe URL wygasło.

Kod	HTTP	Oznaczający
BAD_REQUEST	400 / 409	HTTP 400 oznacza, że treść żądania jest nieprawidłowa; HTTP 409 oznacza, że przesyłanie nie może zostać ukończone w bieżącym stanie.
UNAUTHORIZED	401	Brakuje klucza API, jest on nieprawidłowy lub został unieważniony.
PAID_PLAN_REQUIRED	403	Konto nie ma kwalifikującego się płatnego planu.
INSUFFICIENT_SCOPE	403	Klucz API nie obejmuje wymaganego zakresu.
NOT_FOUND	404	Nie znaleziono przesłanego pliku, pliku lub udziału, którego jesteś właścicielem.
UPLOAD_NOT_READY	409	Przesłany obiekt nie jest gotowy do ukończenia.
FILE_TOO_LARGE	413	Plik przekracza obowiązujący limit rozmiaru.
OBJECT_VALIDATION_FAILED	422	Przesłany obiekt nie przeszedł weryfikacji.
QUOTA_EXCEEDED	429	Limit przesyłania został wyczerpany.
RATE_LIMIT_EXCEEDED	429	Liczba żądań API została wyczerpana.
SERVICE_UNAVAILABLE	503	Wymagana usługa jest chwilowo niedostępna.

Nagłówki ograniczające szybkość

Ponów próbę 429 dopiero po wykonaniu polecenia Retry-After. Ponów próbę tymczasowego błędu 503 z wykładniczym wycofywaniem. Nie ponawiaj automatycznie nieprawidłowych żądań 400, 401 ani 403.