Przypadki błędów

W przypadku błędu organ ochrony danych powinien zwrócić kod stanu HTTP wraz z odpowiedzią HTTP, która MUSI zawierać obiekt JSON z dodatkowymi informacjami o błędzie. Treść odpowiedzi na błąd musi zawierać instancję ErrorResponse.

{
  "errorMessage": string,
  "cause": enum(ErrorCause)
}

Odpowiedź dotycząca błędu w Aneksie o przetwarzaniu danych musi wiązać się z tymi informacjami:

  • Użytkownik korzysta obecnie z roamingu, a zapytania o ochronę danych są dla niego wyłączone. Organ ochrony danych zwraca błąd 403, jako przyczynę błędu: USER_ROAMING.
  • Aneks o przetwarzaniu danych zwraca kod błędu 404 NIE_FOUND, który wskazuje, że klucz użytkownika jest nieprawidłowy (tzn. nie istnieje klucz użytkownika), który ma wartość INVALID_NUMBER.
  • DPA zwraca kod błędu 410 GONE z błędem BAD_CPID wskazującym, że klient powinien otrzymać nowy klucz użytkownika, jeśli parametr key_type = CPID wygasł.
  • Aneks o przetwarzaniu danych zwraca kod błędu 501 NOT_IMPLEMENTED, który wskazuje, że nie obsługuje tego wywołania z przyczyną błędu SERVICE_UNAVAILABLE.
  • Organ ochrony danych zwraca 429 ZA WIĘKSZĄ PRZYPADKĘ z błędem TOO_MANY_REQUESTS i nagłówkiem Ponów po przesłaniu, który wskazuje, że GTAF wysyła zbyt wiele żądań do tego organu.
  • Organ ochrony danych zwraca błąd 409 (CONFLICT), który wskazuje, że nie można zrealizować żądania z powodu konfliktu z jego obecnym stanem.
  • Usługa tymczasowo niedostępna. Organ ochrony danych zwraca błąd 503 SERVICE NIEDOSTĘPNY z nagłówkiem Spróbuj ponownie po tym, jak można spróbować wysłać nowe żądanie.
  • Organ ochrony danych zwraca kod błędu 500 WEWNĘTRZNYCH SERWERA BŁĄDów w przypadku wszystkich nieokreślonych błędów ERROR_CAUSE_UNSPECIFIED jako przyczyna błędu.

Jeśli podczas zakupu wystąpiły błędy, wyświetlane są te kody błędów dotyczące nieudanych transakcji:

  • Aneks o przetwarzaniu danych zwraca kod błędu 400 BAD REQUEST, który informuje GTAF, że kupiony identyfikator pakietu jest nieprawidłowy.
  • Aneks o przetwarzaniu danych zwraca kod błędu WYMAGANY PAYMENT 402, który wskazuje, że użytkownik nie ma wystarczających środków, by dokończyć zakup.
  • Organ ochrony danych zwraca kod błędu 4F (409), który wskazuje, że abonament jest niezgodny z obecnym zestawem usług użytkownika. Jeśli na przykład zasady abonamentu danych nie zezwalają na łączenie abonamentów przedpłaconych i przedpłaconych, próba zakupu abonamentu przedpłaconego dla użytkownika abonamentowego spowoduje błąd 409 CONFLICT.
  • Organ ochrony danych zwraca kod błędu 403 FORBIDDEN wskazujący, że bieżąca transakcja jest duplikatem wcześniej zrealizowanej transakcji. Organ ochrony danych powinien zwrócić w odpowiedzi te przyczyny błędów:
    • Jeśli poprzednia transakcja się nie powiodła, wystąpił błąd, który wskazuje przyczynę niepowodzenia.
    • Jeśli poprzednia transakcja zakończyła się powodzeniem, DUPLICATE_TRANSACTION.
    • Jeśli wcześniejsza transakcja jest nadal w kolejce, REQUEST_QUEUED.