REST- und Antwortheader in Partner Center, die von der Partner Center-REST-API unterstützt werden
anwendbar auf: Partnerzentrum | Partnerzentrum betrieben von 21Vianet | Partnerzentrum für die Microsoft-Cloud für die US-Regierung
Die Partner Center-REST-API unterstützt die folgenden HTTP-Anforderungs- und Antwortheader. Nicht alle API-Aufrufe akzeptieren alle Header.
REST-Anforderungsheader
Die Partner Center-REST-API unterstützt die folgenden HTTP-Anforderungsheader.
Header | Beschreibung | Werttyp |
---|---|---|
Authorization: |
Erforderlich. Das Autorisierungstoken in Form eines <Bearertoken>. | Zeichenfolge |
Accept: |
Gibt den Anforderungs- und Antworttyp application/jsonan. | Zeichenfolge |
MS-RequestId: |
Ein eindeutiger Bezeichner für den Aufruf, der verwendet wird, um die ID-Stärke sicherzustellen. Wenn ein Timeout vorhanden ist, sollte der Wiederholungsaufruf denselben Wert enthalten. Nach Erhalt einer Antwort (Erfolg oder Geschäftsausfall) sollte der Wert für den nächsten Aufruf zurückgesetzt werden. | GUID |
MS-CorrelationId: |
Ein eindeutiger Bezeichner für den Aufruf, nützlich in Protokollen und Netzwerkablaufverfolgungen zur Problembehandlung bei Fehlern. Der Wert sollte für jeden Anruf zurückgesetzt werden. Alle Vorgänge sollten diesen Header enthalten. Weitere Informationen finden Sie in den Korrelations-ID-Informationen unter Testen und Debuggen. | GUID |
MS-Contract-Version: |
Erforderlich. Gibt die version der angeforderten API an; Dieser Wert ist in der Regel api-version: v1, sofern im Abschnitt Scenarios nicht anders angegeben. | Zeichenfolge |
If-Match: |
Wird für die Parallelitätssteuerung verwendet. Bei einigen API-Aufrufen muss das ETag über den If-Match-Header übergeben werden. Das ETag befindet sich in der Regel in der Ressource und erfordert daher das Abrufen des aktuellen Werts per GET. Weitere Informationen finden Sie in den ETag-Informationen unter Testen und Debuggen. | Zeichenfolge |
MS-PartnerCenter-Application |
Wahlfrei. Gibt den Namen der Anwendung an, die die Partner Center-REST-API verwendet. | Zeichenfolge |
X-Locale: |
Wahlfrei. 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 Von Partner Center unterstützte Sprachen und Gebietsschemas. | Zeichenfolge |
REST-Antwort-Kopfzeilen
Die Partner Center-REST-API gibt möglicherweise die folgenden HTTP-Antwortheader zurück.
Header | Beschreibung | Werttyp |
---|---|---|
Accept: |
Gibt den Anforderungs- und Antworttyp application/jsonan. | Zeichenfolge |
MS-RequestId: |
Ein eindeutiger Bezeichner für den Aufruf, der verwendet wird, um die ID-Stärke sicherzustellen. Wenn ein Timeout vorhanden ist, sollte der Wiederholungsaufruf denselben Wert enthalten. Nach Erhalt einer Antwort (Erfolg oder Geschäftsausfall) sollte der Wert für den nächsten Aufruf zurückgesetzt werden. | GUID |
MS-CorrelationId: |
Ein eindeutiger Bezeichner für den Aufruf. Dieser Wert ist nützlich für die Problembehandlung von Protokollen und Netzwerkablaufverfolgungen, um den Fehler zu finden. Der Wert sollte für jeden Anruf zurückgesetzt werden. Alle Vorgänge sollten diesen Header enthalten. | GUID |