Intestazioni REST e risposta del Centro per i partner supportate dall'API REST del Centro per i partner
Si applica a: Centro per i partner | Centro per i partner gestito da 21Vianet | Centro per i partner per Microsoft Cloud per il governo degli Stati Uniti
L'API REST del Centro per i partner supporta le intestazioni di richiesta e risposta HTTP seguenti. Non tutte le chiamate API accettano tutte le intestazioni.
Intestazioni di richiesta REST
L'API REST del Centro per i partner supporta le intestazioni di richiesta HTTP seguenti sono supportate dall'API REST del Centro per i partner.
| Intestazione | Descrizione | Tipo di valore |
|---|---|---|
| Autorizzazione: | Obbligatorio. Il token di autorizzazione nel formato Bearer <token>. | string |
| Accetta: | Specifica il tipo di richiesta e risposta, application/json. | string |
| MS-RequestId: | Identificatore univoco della chiamata, usato per garantire la potenza dell'ID. Se è presente un timeout, la chiamata di ripetizione dei tentativi deve includere lo stesso valore. Al momento della ricezione di una risposta (esito positivo o negativo), il valore deve essere reimpostato per la chiamata successiva. | GUID |
| MS-CorrelationId: | Identificatore univoco della chiamata, utile nei log e nelle tracce di rete per la risoluzione dei problemi relativi agli errori. Il valore deve essere reimpostato per ogni chiamata. Tutte le operazioni devono includere questa intestazione. Per altre informazioni, vedere le informazioni sull'ID correlazione in Test e debug. | GUID |
| MS-Contract-Version: | Obbligatorio. Specifica la versione dell'API richiesta; Questo valore è in genere api-version: v1, a meno che non diversamente specificato nella sezione Scenari . | string |
| If-Match: | Usata per il controllo della concorrenza. Per alcune chiamate API è necessario passare l'elemento ETag tramite l'intestazione If-Match. L'elemento ETag si trova in genere nella risorsa ed è pertanto necessario ottenere la versione più recente tramite GET. Per altre informazioni, vedere le informazioni ETag in Test e debug. | string |
| MS-PartnerCenter-Application | Facoltativo. Specifica il nome dell'applicazione che usa l'API REST del Centro per i partner. | string |
| Impostazioni locali X: | Facoltativo. Specifica la lingua in cui vengono restituite le frequenze. Il valore predefinito è en-US. Per un elenco dei valori supportati, vedere Lingue e impostazioni locali supportate dal Centro per i partner. | string |
Intestazioni di risposta REST
L'API REST del Centro per i partner potrebbe restituire le intestazioni di risposta HTTP seguenti:
| Intestazione | Descrizione | Tipo di valore |
|---|---|---|
| Accetta: | Specifica il tipo di richiesta e risposta, application/json. | string |
| MS-RequestId: | Identificatore univoco della chiamata, usato per garantire la potenza dell'ID. Se è presente un timeout, la chiamata di ripetizione dei tentativi deve includere lo stesso valore. Al momento della ricezione di una risposta (esito positivo o negativo), il valore deve essere reimpostato per la chiamata successiva. | GUID |
| MS-CorrelationId: | Identificatore univoco per la chiamata. Questo valore è utile per la risoluzione dei problemi relativi ai log e alle tracce di rete per trovare l'errore. Il valore deve essere reimpostato per ogni chiamata. Tutte le operazioni devono includere questa intestazione. | GUID |