Codici di Stato HTTP

Oltre ai metodi HTTP, i codici di stato HTTP della risposta sono particolarmente importanti, poiché vengono utilizzati per identificare il successo o il fallimento di un'operazione.

Le Cinque Principali Categorie di Codici di Stato

Le cinque principali categorie di codici di stato, identificate dalla prima cifra del codice, sono:

1xx: Informativo

Il server informa il client che la richiesta è stata ricevuta e il processo è in corso.

2xx: Successo

L'operazione è stata completata con successo. Il server ha ricevuto, elaborato e accettato l'input del client, e l'utente vede tipicamente la pagina web o la risorsa richiesta.

3xx: Reindirizzamento

Il server riceve la richiesta, ma sono necessarie ulteriori azioni e passaggi sul lato client per completarla correttamente, poiché ci sono inoltri e reindirizzamenti.

4xx: Errore del Client

Questa è la prima categoria di errori: la richiesta non può essere completata a causa di problemi lato client, come sintassi errata o una pagina rimossa. L'utente vede una pagina HTML automatica che indica l'errore.

5xx: Errore del Server

Questo tipo di codice indica problemi lato server che impediscono il completamento con successo di una richiesta apparentemente valida. L'errore del server può essere temporaneo o permanente, e l'utente riceve anche una pagina HTML che indica il problema.

Codici di Stato della WebAPI di TeamSystem Enterprise

I codici gestiti nelle operazioni standard nella WebAPI di TSEnterprise sono:

200: Successo

Operazione riuscita; questa è la risposta standard e più comune nel caso di un'operazione eseguita correttamente

201: Creato

Risorsa creata; utilizzato nel metodo POST per creare una NUOVA risorsa

202: Accettato

Richiesta accettata; utilizzato, ad esempio, quando si utilizzano servizi asincroni e indica che la richiesta è stata presa in carico

400: Richiesta Errata

Operazione fallita; questa è la risposta standard e più comune nel caso di errori durante l'esecuzione dell'operazione

401: Non Autorizzato

Utilizzato esclusivamente in caso di errori di autenticazione

403: Vietato

In caso di errori di permesso/autorizzazione

404: Non Trovato

Se la risorsa non viene trovata (ad esempio, se effettuo una GET su una risorsa specificando un id inesistente)

405: Metodo Non Consentito

In caso di metodi HTTP non supportati (ad esempio, un PUT su una risorsa che supporta solo operazioni di lettura)

409: Conflitto

principalmente utilizzato in due casi:

• per indicare il fallimento di un'operazione di “Creazione,” “Aggiornamento,” o “Eliminazione” a causa della logica di business (ad esempio, errori di validazione dell'entità o avvisi di business)
• per indicare una risorsa NON VALIDA nelle operazioni di “Validazione” e “ValidazioneProprietà”

500: Errore Interno del Server

In caso di errori non gestiti durante l'esecuzione della richiesta