Kody statusu HTTP

Interfejs API MC używa standardowych kodów statusu HTTP w odpowiedzi, aby wskazać powodzenie lub niepowodzenie żądania. O ile w opisie operacji nie określono inaczej, zastosowanie mają następujące ogólne interpretacje wartości kodów statusu.

Tabela 1. Kody statusu HTTP
Kod statusu HTTP Komunikat o statusie HTTP Opis
200 OK Żądanie zakończyło się pomyślnie. Udostępniana jest treść odpowiedzi, która zawiera wyniki żądania.
204 Brak treści Żądanie zakończyło się pomyślnie i nie podano dodatkowych informacji o odpowiedzi.
400 Błędne żądanie Żądanie nie zawierało wymaganych danych wejściowych, zawierało błędy w podanych danych wejściowych lub zawierało dodatkowe dane wejściowe. Dodatkowe informacje dotyczące błędu są udostępniane w treści odpowiedzi na błąd, która zawiera kod przyczyny wraz z dodatkowymi informacjami.
403 Zabronione Wiele warunków błędu powoduje wystąpienie następującego kodu statusu:
  • Żądanie wymaga uwierzytelnienia, ale nie podano nagłówka X-API-Session lub podano jeden nagłówek, ale identyfikator sesji był niepoprawny.
  • Użytkownik, który uwierzytelnił żądanie API, nie ma uprawnień do wykonania żądanej operacji.
404 Nie znaleziono Wiele warunków błędu powoduje wystąpienie następującego kodu statusu:
  • Identyfikator URI nie wskazuje na istniejący zasób lub wskazuje zasób, do którego użytkownik interfejsu API nie ma uprawnień dostępu do obiektu.
  • Identyfikator URI wskazuje zasób lub operację, która nie jest obsługiwana przez kontekst monitorowania, ponieważ jest on obecnie alternatywnym kontekstem monitorowania.
405 Niedozwolona metoda Żądanie określa metodę HTTP, która nie jest poprawna dla wyznaczonego identyfikatora URI.
409 Konflikt Zasób zarządzany jest w niepoprawnym stanie (status) dla wykonania żądanej operacji. Dodatkowe informacje dotyczące błędu są udostępniane w treści odpowiedzi na błąd, która zawiera kod przyczyny wraz z dodatkowymi informacjami.
412 Zmodyfikowano zasób Warunek wstępny nie powiódł się. Jeśli klient dostarczył znacznik ETag i serwer jest zgodny, kontynuuj od metody POST. W przeciwnym razie wystąpi 412 błąd modyfikacji zasobu.
413 Treść żądania jest zbyt duża Żądanie zawiera zbyt dużą treść żądania.
415 Nieobsługiwany typ nośnika Nagłówek Content-Type dla żądania określa reprezentację, która nie jest obsługiwana przez interfejs API Web Services .
500 Wewnętrzny błąd serwera Wystąpił błąd serwera podczas przetwarzania żądania.
501 nie zostało zaimplementowane Żądanie określa metodę HTTP, która nie jest rozpoznawana przez serwer (dla żadnego zasobu).
503 Usługa niedostępna Żądanie nie mogło zostać wykonane przez kontekst monitorowania z powodu tymczasowego warunku.
505 Wersja HTTP nie jest obsługiwana Żądanie określa wersję protokołu HTTP, która nie jest obsługiwana przez interfejs API Web Services .