Intestazioni REST e risposta del Centro per i partner supportate dall'API REST del Centro per i partner

  • Articolo

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