Webhook - Get Validation Events

Dienst:

Partner Center Rest

API-Version:

v1

Ruft den Status eines Testwebhooks anhand der Korrelations-ID ab.

GET https://api.partnercenter.microsoft.com/webhooks/v{version}/registration/validationEvents/{correlationId}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
correlationId	path	True	string	CorrelationId, die von der ursprünglichen Testmethode zurückgegeben wurde
version	path	True	string

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
Authorization	True	string	Bearer-Authentifizierungstoken
ms-correlationid		string	Ein eindeutiger Bezeichner für den Anruf, 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.
ms-requestid		string	Ein eindeutiger Bezeichner für den Anruf, der verwendet wird, um die Idempotenz sicherzustellen. Im Falle eines Timeouts sollte der Wiederholungsaufruf denselben Wert enthalten. Nach Erhalt einer Antwort (Erfolg oder Geschäftsfehler) sollte der Wert für den nächsten Anruf zurückgesetzt werden.

Antworten

Name	Typ	Beschreibung
200 OK	WebhookValidationEvent	OKAY Media Types: "application/json", "text/json"
400 Bad Request		Es fehlte eine oder eine ungültige Eingabe. Der Antworttext enthält die Fehlerdetails. Media Types: "application/json", "text/json"
401 Unauthorized		Die Anforderung wurde nicht authentifiziert. Der Client muss sich zuerst beim Partner-API-Dienst authentifizieren. Media Types: "application/json", "text/json"
403 Forbidden		Die Anforderung wurde authentifiziert, wurde aber abgelehnt, da der Aufrufer nicht über die Rechte zum Aufrufen verfügt. Media Types: "application/json", "text/json"
404 Not Found		Die Ressource wurde mit den angegebenen Eingabeparametern nicht gefunden oder nicht verfügbar. Media Types: "application/json", "text/json"
500 Internal Server Error		Der Partner-API-Dienst oder eine seiner Abhängigkeiten konnte die Anforderung nicht erfüllen. Anrufer versuchen dies möglicherweise erneut. Media Types: "application/json", "text/json"

Sicherheit

Authorization

Bearer-Authentifizierungstoken

Typ: apiKey
In: header

Definitionen

Name	Beschreibung
WebhookResponse
WebhookValidationEvent

WebhookResponse

Objekt

Name	Typ	Beschreibung
dateTimeUtc	string (date-time)
responseCode	string
responseMessage	string
systemError	boolean

WebhookValidationEvent

Objekt

Name	Typ	Beschreibung
callbackUrl	string
correlationId	string
partnerId	string
results	WebhookResponse[]
status	string