Condividi tramite

Intestazioni REST e di risposta 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.

Intestazione Descrizione Tipo valore
Authorization: Obbligatorio. Token di autorizzazione nel formato Bearer <token>. corda
Accept: Specifica il tipo di richiesta e risposta, application/json. corda
MS-RequestId: Identificatore univoco per la chiamata, usato per garantire la potenza dell'ID. Se è presente un timeout, la chiamata di ripetizione dei tentativi deve includere lo stesso valore. Quando si riceve una risposta (esito positivo o negativo aziendale), il valore deve essere reimpostato per la chiamata successiva. GUID
MS-CorrelationId: Identificatore univoco per la chiamata, utile nei log e nelle tracce di rete per la risoluzione degli errori. Il valore deve essere reimpostato per ogni chiamata. Tutte le operazioni devono includere questa intestazione. Per ulteriori dettagli, consultare l'ID di correlazione nella sezione test e debugging. GUID (Identificatore Univoco Globale)
MS-Contract-Version: Obbligatorio. Specifica la versione dell'API richiesta; Di solito, questo valore è api-version: v1, a meno che non sia diversamente specificato nella sezione Scenari . corda
If-Match: Usato per il controllo della concorrenza. Alcune chiamate API richiedono il passaggio dell'ETag tramite l'intestazione If-Match. L'ETag si trova di solito nella risorsa e, di conseguenza, richiede di eseguire un'operazione GET per ottenere la versione più recente. Per altre informazioni, vedere le informazioni ETag in Test e debug. corda
MS-PartnerCenter-Application Opzionale. Specifica il nome dell'applicazione che usa l'API REST del Centro per i partner. corda
X-Locale: Opzionale. Specifica la lingua in cui vengono restituite le tariffe. Il valore predefinito è en-US. Per un elenco dei valori supportati, vedere lingue e impostazioni locali supportate dal Partner Center. corda

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
Accept: Specifica il tipo di richiesta e risposta, application/json. corda
MS-RequestId: Identificatore univoco per la chiamata, usato per garantire la potenza dell'ID. Se è presente un timeout, la chiamata di ripetizione dei tentativi deve includere lo stesso valore. Quando si riceve una risposta (esito positivo o negativo aziendale), il valore deve essere reimpostato per la chiamata successiva. GUID (Identificatore Globale Unico)
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 (Identificatore Univoco Globale)