Codici di risposta
Quando si chiama una qualsiasi delle risorse API REST dei domini di Identity, l'intestazione Risposta restituisce uno dei codici di stato HTTP standard.
Vedere la sezione Status Code Definitions del protocollo Hypertext Transfer Protocol -- HTTP/1.1.
Codice stato HTTP |
descrizione; |
---|---|
200 OK
|
Richiesta 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. Lo stato 201 viene restituito 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 eventualmente essere presa in considerazione, in quanto potrebbe non essere consentita al momento dell'elaborazione effettiva. Quando si specifica una creazione di risorsa La risposta contiene un'intestazione Location di una risorsa job di cui il client deve eseguire il polling per determinare quando il job è terminato. Restituisce anche un'entità che contiene lo stato corrente del job |
204 No Content
|
Operazione riuscita. Nessun contenuto da inviare nel corpo della risposta. Questo viene in genere inviato con successo DELETE. |
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 va ripetuta nel luogo individuato e utilizzata 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
|
Richiesta non autorizzata. Le credenziali di autenticazione incluse in questa richiesta sono mancanti o non valide. |
403 Forbidden
|
Operazione di richiesta non supportata. |
404 Not Found
|
La richiesta include un URI di risorsa che non esiste. |
405 Method Not Allowed
|
Il verbo HTTP specificato nella richiesta (DELETE, GET, POST, PUT) non è supportato su questa risorsa oppure il metodo richiede un filtro, che non è stato fornito. |
409 Conflict
|
Il numero di versione non corrisponde oppure è stata richiesta una risorsa duplicata che non può essere ricreata. |
412 Precondition Failed
|
Aggiornamento non riuscito, poiché la risorsa è stata modificata. |
413 Request Entity Too Large
|
È stato superato il valore maxOperations (1000) o maxPayload (1048576). |
415 Not Acceptable
|
L'intestazione ContentType del client non è corretta (ad esempio, il client tenta di inviare la richiesta in formato XML, ma la risorsa può accettare solo JSON). |
500 Internal Server Error
|
Il server ha rilevato una condizione imprevista che ha bloccato l'esecuzione della richiesta. |
501 Not Implemented
|
L'operazione richiesta non è supportata. |
503 Service Unavailable
|
Il server non è in grado di gestire la richiesta a causa di un sovraccarico temporaneo o di attività di gestione. L'applicazione Web REST dei domini di Identity non è attualmente in esecuzione. |