Specifica delle intestazioni HTTP

Alcune personalizzazioni di richieste richiedono l'impostazione delle intestazioni HTTP . Le intestazioni Content-Type e Accept controllano il formato di input e output. L'intestazione Range controlla l'impaginazione. L'intestazione Compressione controlla la compressione.

Intestazioni Content-Type e Accept

Per specificare i tipi di contenuto del corpo della richiesta e dell'output, utilizzare le intestazioni Content-Type e Accept.

Tabella 1. Valori dell'intestazione Content-Type e Accept
Nome intestazione Valore Descrizione
Content-Type application/json Indica che il formato del corpo della richiesta è JSON.
application/xml Indica che il formato del corpo della richiesta è XML.
application/x-www-form-urlencoded Indica che il corpo della richiesta è codificato URL .
Accept application/json Imposta il tipo di output su JSON.
application/json;indent=2 Imposta il tipo di output su JSON formattato.
application/xml Imposta il tipo di output su XML.

Intervallo

L'intestazione Range controlla la paginazione nelle chiamate API List.

Tabella 2. Valori intestazione intervallo
Nome intestazione Valore Descrizione
Range items=x-y Restituisce i record con ID riga da x a y. In alternativa, è possibile specificare l'intervallo nella richiesta URL con il parametro _range=x-y.

Compressione

Per comprimere i dati in una risposta, impostare l'intestazione Accept-Encoding .

Tabella 3. Valori intestazione compressione
Nome intestazione Valore Descrizione
Accept-Encoding gzip Restituisce i risultati compressi con formato GNU .ZIP.
identity Restituisce i risultati con la codifica identità (nessuna trasformazione).

X -HTTP-Metodo - Sovrascrivi

Se non sei in grado di utilizzare un verbo HTTP in una richiesta, invia una richiesta POST con il verbo come valore per l'intestazione di sovrascrittura. La richiesta si comporta come se la chiamata fosse effettuata con il comando HTTP indicato nell'intestazione di sovrascrittura.

Ad esempio, se non riesci a passare una richiesta DELETE per il numero d'ordine 12345, imposta l'intestazione X-HTTP-Method-Override su DELETE e utilizza la richiesta HTTP :
POST https://host:port/contextRoot/restapi/order/12345
È anche possibile utilizzare l'intestazione X-HTTP-Method-Override per passare i parametri nelle richieste GET che superano il limite di dimensioni di un URL URL. Eseguire una POST sull' URL, impostare l'intestazione Content-Type su application/x-www-form-urlencodede impostare l'intestazione X-HTTP-Method-Override su GET.
Tabella 4. X -HTTP-Method - Override header values
Nome intestazione Valore
X-HTTP-Method-Override GET
  PATCH
  DELETE