Header der Partner-REST-API
Die Partner-REST-API unterstützt folgende HTTP-Anforderungs- und -Antwortheader.
Hinweis
Nicht alle Header werden von allen API-Aufrufen akzeptiert.
Anforderungsheader
Folgende HTTP-Anforderungsheader werden von der Partner-REST-API unterstützt:
| Header | Werttyp | BESCHREIBUNG |
|---|---|---|
| Authorization | Zeichenfolge | Erforderlich. Das Autorisierungstoken im Format „Bearer <Token>“. |
| Akzeptieren | Zeichenfolge | Gibt den Anforderungs- und Antworttyp (application/json) an. |
| client-request-id | GUID | Erforderlich. 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. |
| If-Match: | Zeichenfolge | Wird für die Parallelitätssteuerung verwendet. Bei einigen API-Aufrufe muss das ETag über den If-Match-Header übergeben werden. Das ETag befindet sich normalerweise in der Ressource und erfordert daher, dass Sie die neueste Version erhalten. |
Antwortheader
Von der Partner-REST-API können folgende HTTP-Antwortheader zurückgegeben werden.
| Header | Werttyp | BESCHREIBUNG |
|---|---|---|
| Akzeptieren | Zeichenfolge | Gibt den Anforderungs- und Antworttyp (application/json) an. |
| request-id | GUID | Ein eindeutiger Bezeichner für den Aufruf, um die ID-Potenz sicherzustellen. Im Falle eines Timeouts muss der erneute Aufruf den gleichen Wert enthalten. Nach Eingang einer Antwort (Erfolg oder Fehler) muss der Wert für den nächsten Aufruf zurückgesetzt werden. |
| client-request-id | GUID | 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. |
| x-ms-ags-diagnostic | Zeichenfolge | Eine Zeichenfolge mit Diagnoseinformationen des Diensts. |
| timestamp | Zeichenfolge | Zeitstempel der Anforderung bei Erreichen der API. |
| ETag | Zeichenfolge | ETag der Ressource. |