Przejdź do głównej zawartości

Błędy

Błąd to status HTTP z treścią w formacie JSON:

{ "code": "INVALID_INPUT", "messageKey": "…", "retryable": false, "correlationId": "…" }
  • code jest stały: opieraj na nim swoją logikę.
  • retryable: true oznacza, że to samo żądanie można wysłać ponownie później.
  • Zapisuj w logach code i correlationId (nigdy klucz) i podawaj correlationId, gdy piszesz do pomocy technicznej.
Status Kod Kiedy Co zrobić
400 INVALID_INPUT Błędne żądanie, pole lub nieznany parametr Popraw żądanie; nie powtarzaj go w tej samej postaci
401 NOT_AUTHENTICATED Brak klucza, błędny klucz albo klucz został zastąpiony Zatrzymaj się i sprawdź klucz
403 FORBIDDEN Konto marki jest zablokowane w suly.gg Zatrzymaj się i skontaktuj z pomocą techniczną
404 NOT_FOUND Nie ma takiego uczestnika w tej ofercie albo adres jest nieznany Sprawdź identyfikator i ścieżkę
409 OFFER_ENDED Oferta jest zamknięta: kody i naliczenia nie są już przyjmowane Zatrzymaj zadania; odczyt nadal działa
409 PARTICIPANT_NOT_ACTIVE Naliczenie dla twórcy bez kodu albo takiego, któremu odmówiono Najpierw prześlij kod
409 CREATOR_BANNED Twórca jest zablokowany w suly.gg Nie płać
409 INSUFFICIENT_BUDGET Budżet jest mniejszy niż kwota plus prowizja Doładuj budżet oferty, a potem powtórz
409 EXTERNAL_ID_CONFLICT Ten externalId został użyty z innymi danymi Wyjaśnij sprawę; nigdy nie nadpisuj
429 (limit żądań) Zbyt wiele żądań Powtórz później, po przerwie
503 DEPENDENCY_UNAVAILABLE Błąd tymczasowy Powtórz to samo żądanie później