Codici di Stato HTTP

L'API MC utilizza i codici di stato HTTP standard in risposta per indicare l'esito positivo o negativo della richiesta. Salvo diversa indicazione nella descrizione di un'operazione, si applicano le seguenti interpretazioni generali dei valori del codice di stato.

Tabella 1. Codici di stato
Codice stato HTTP Messaggio di stato HTTP Descrizione
200 OK La richiesta è stata completata. Viene fornito un corpo della risposta che contiene i risultati della richiesta.
204 Nessun contenuto La richiesta è stata completata e non sono state fornite ulteriori informazioni di risposta.
400 Richiesta non valida La richiesta non conteneva l'input richiesto, conteneva errori nell'input fornito o includeva l'input estraneo. Ulteriori informazioni relative all'errore vengono fornite in un corpo della risposta di errore che include un codice motivo con ulteriori informazioni.
403 Non consentito Più condizioni di errore risultano in questo codice di stato:
  • La richiesta richiede l'autenticazione ma non è stata fornita alcuna intestazione X - API - Session oppure ne è stata fornita una ma l'ID sessione non era valido.
  • L'utente con cui è stata autenticata la richiesta API non è autorizzato ad eseguire l'operazione richiesta.
404 Non trovato Più condizioni di errore risultano in questo codice di stato:
  • L'URI non designa una risorsa esistente o designa una risorsa per la quale l'utente API non dispone dell'autorizzazione di accesso all'oggetto.
  • L'URI indica una risorsa o un'operazione che non è supportata dall'MC perché attualmente è l'MC alternativo.
405 Metodo non consentito La richiesta specifica un metodo HTTP non valido per l'URI designato.
409 Conflitto La risorsa gestita si trova in uno stato non corretto (stato) per l'esecuzione dell'operazione richiesta. Ulteriori informazioni relative all'errore vengono fornite in un corpo della risposta di errore che include un codice motivo con ulteriori informazioni.
412 Risorsa modificata Precondizione non riuscita. Se il client ha fornito ETag e il server ETag corrispondono, procedere con POST. Altrimenti, si verifica un errore di modifica della risorsa 412.
413 Corpo della richiesta troppo grande La richiesta include un corpo della richiesta troppo grande.
415 Tipo di supporto non supportato L'intestazione Content-Type per la richiesta specifica una rappresentazione non supportata dall'API Web Services .
500 Errore interno del server Si è verificato un errore del server durante l'elaborazione della richiesta.
501 Non implementato La richiesta specifica un metodo HTTP non riconosciuto dal server (per qualsiasi risorsa).
503 Servizio non disponibile La richiesta non è stata eseguita dall'MC a causa di una condizione temporanea.
505 Versione HTTP non supportata La richiesta specifica una versione del protocollo HTTP non supportata dall'API Web Services .