Partner Center-REST- und Antwortheader, die von der Partner Center-REST-API unterstützt werden

  • Artikel

Gilt für: Partner Center | Partner Center-Betrieb durch 21Vianet | Partner Center für Microsoft Cloud for US Government

Die Partner Center-REST-API unterstützt die folgenden HTTP-Anforderungs- und Antwortheader. Nicht alle Header werden von allen API-Aufrufen akzeptiert.

REST-Anforderungsheader

Die Partner Center-REST-API unterstützt die folgenden HTTP-Anforderungsheader werden von der Partner Center-REST-API unterstützt.

Header Beschreibung Typ
Authorization: Erforderlich. Das Autorisierungstoken im Format „Bearer <Token>“. Zeichenfolge
Annehmen: Gibt den Anforderungs- und Antworttyp "Application/json" an. Zeichenfolge
MS-RequestId: Ein eindeutiger Bezeichner für den Aufruf, um die ID-Potenz sicherzustellen. Wenn ein Timeout vorhanden ist, sollte der Wiederholungsaufruf denselben Wert enthalten. Nach Eingang einer Antwort (Erfolg oder Fehler) muss der Wert für den nächsten Aufruf zurückgesetzt werden. GUID
MS-CorrelationId: Ein eindeutiger Bezeichner für den Aufruf. Hilfreich in Protokollen und Netzwerkablaufverfolgungen für die Fehlerbehandlung. Der Wert muss für jeden Aufruf zurückgesetzt werden. Alle Vorgänge müssen diesen Header enthalten. Weitere Informationen finden Sie in den Korrelations-ID-Informationen im Test und Debug. GUID
MS-Contract-Version: Erforderlich. Gibt die version der angeforderten API an; Dieser Wert ist in der Regel api-version: v1, sofern nicht anders im Abschnitt "Szenarien" angegeben. Zeichenfolge
If-Match: Wird für die Parallelitätssteuerung verwendet. Bei einigen API-Aufrufe muss das ETag über den If-Match-Header übergeben werden. Da sich das ETag normalerweise in der Ressource befindet, muss das neueste ETag mittels GET abgerufen werden. Weitere Informationen finden Sie in den ETag-Informationen in Test und Debug. Zeichenfolge
MS-PartnerCenter-Application Optional. Gibt den Namen der Anwendung an, die die Partner Center-REST-API verwendet. Zeichenfolge
X-Gebietsschema: Optional. Gibt die Sprache an, in der die Raten zurückgegeben werden. Der Standardwert ist "en-US". Eine Liste der unterstützten Werte finden Sie unter Partner Center unterstützte Sprachen und Gebietsschemas. Zeichenfolge

REST-Antwortheader

Die Partner Center-REST-API gibt möglicherweise die folgenden HTTP-Antwortheader zurück:

Header Beschreibung Typ
Annehmen: Gibt den Anforderungs- und Antworttyp "Application/json" an. Zeichenfolge
MS-RequestId: Ein eindeutiger Bezeichner für den Aufruf, um die ID-Potenz sicherzustellen. Wenn ein Timeout vorhanden ist, sollte der Wiederholungsaufruf denselben Wert enthalten. Nach Eingang einer Antwort (Erfolg oder Fehler) muss der Wert für den nächsten Aufruf zurückgesetzt werden. GUID
MS-CorrelationId: Ein eindeutiger Bezeichner für den Anruf. Dieser Wert ist nützlich für die Problembehandlung von Protokollen und Netzwerkablaufverfolgungen, um den Fehler zu finden. Der Wert muss für jeden Aufruf zurückgesetzt werden. Alle Vorgänge müssen diesen Header enthalten. GUID