Codici di risposta

Quando si chiama una qualsiasi delle risorse API REST dei domini di identità, l'intestazione Risposta restituisce uno dei codici di stato HTTP standard.

Vedere la sezione Definizioni dei codici di stato del protocollo di trasferimento ipertestuale -- HTTP/1.1.

Codice stato HTTP

Descrizione

200 OK La richiesta è stata completata. Viene restituito uno stato 200 per un metodo GET riuscito.
201 Created La richiesta è stata completata e di conseguenza è stata creata una nuova risorsa. La risposta include un'intestazione Location contenente l'URI canonico per la risorsa appena creata.

Viene restituito uno stato 201 dalla creazione di una risorsa sincrona o dalla creazione di una risorsa asincrona completata prima della restituzione della risposta.

202 Accepted La richiesta è stata accettata per l'elaborazione, ma l'elaborazione non è stata completata. La richiesta potrebbe o non potrebbe essere eseguita in seguito, in quanto potrebbe non essere consentita al momento dell'elaborazione effettiva.

Quando si specifica la creazione asincrona di una risorsa (__detached=true) (ad esempio quando si distribuisce un'applicazione) o l'aggiornamento (ad esempio quando si ridistribuisce un'applicazione), viene restituito un valore 202 se l'operazione è ancora in corso. Se __detached=false, può essere restituito un 202 se l'operazione sottostante non viene completata in un periodo di tempo ragionevole.

La risposta contiene un'intestazione Location di una risorsa job che il client deve eseguire per determinare quando il job è terminato. Restituisce inoltre un'entità che contiene lo stato corrente del job

204 No Content Operazione riuscita. Nessun contenuto da inviare nel corpo della risposta. In genere viene inviato su DELETE. riuscito
307 Temporary Redirect La richiesta deve essere ripetuta nella posizione temporanea identificata, ma utilizzare la posizione originale come riferimento permanente alla risorsa.
308 Permanent Redirect La richiesta dovrebbe essere ripetuta nella posizione identificata e utilizzarla come riferimento permanente alla risorsa.
400 Bad Request Impossibile elaborare la richiesta perché contiene informazioni mancanti o non valide, ad esempio un errore di convalida in un campo di input, un valore obbligatorio mancante e così via.
401 Unauthorized La richiesta non è autorizzata. Credenziali di autenticazione incluse in questa richiesta mancanti o non valide.
403 Forbidden L'operazione di richiesta non è supportata.
404 Not Found La richiesta include un URI risorsa che non esiste.
405 Method Not Allowed Il verbo HTTP specificato nella richiesta (DELETE, GET, POST, PUT) non è supportato in questa risorsa oppure il metodo richiede un filtro non fornito.
409 Conflict Il numero di versione non corrisponde oppure è stata richiesta una risorsa duplicata e non può essere ricreata.
412 Precondition Failed Aggiornamento non riuscito poiché la risorsa è stata modificata.
413 Request Entity Too Large maxOperations (1000) o maxPayload (1048576) è stato superato.
415 Not Acceptable L'intestazione ContentType del client non è corretta (ad esempio, il client tenta di inviare la richiesta in XML, ma la risorsa può accettare solo JSON).
500 Internal Server Error Il server ha rilevato una condizione imprevista che ha impedito di soddisfare la richiesta.
501 Not Implemented L'operazione richiesta non è supportata.
503 Service Unavailable Il server è in grado di gestire la richiesta a motivo di sovraccarico temporaneo o di un'operazione di manutenzione del server. L'applicazione Web REST dei domini di Identity non è attualmente in esecuzione.