Freigeben über

Abonnement erstellen

  • Artikel

Abonniert eine Listener-Anwendung zum Empfangen von Benachrichtigungen, wenn Daten geändert werden.

Berechtigungen

Eine der folgenden Berechtigungen ist erforderlich, um diese API aufzurufen. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All
Anwendung Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

HTTP-Anforderung

POST /subscriptions

Antwort

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 201 Created und ein subscription-Objekt im Antworttext zurückgegeben.

Beispiel

Anforderung

Hier sehen Sie ein Beispiel für die Anforderung zum Senden einer Benachrichtigung, wenn die Inhalte des Laufwerks eines Benutzers sich ändern.

POST /subscriptions
Content-type: application/json

{
 "changeType": "updated",
 "notificationUrl": "https://contoso.azurewebsites.net/api/webhook-receiver",
 "resource": "/me/drive/root",
 "expirationDateTime": "2018-01-01T11:23:00.000Z",
 "clientState": "client-specific string"
}

Antwort

Wenn das Abonnement hinzugefügt wird, wird eine 201 Created-Antwort zurückgegeben, die das neu erstellte Abonnementobjekt enthält.

HTTP/1.1 201 Created
Content-Type: application/json

{
    "id": "1039149811asbc",
    "resource": "/me/drive/root",
    "changeType": "updated",
    "clientState": "client-specific string",
    "notificationUrl": "https://contoso.azurewebsites.net/api/webhook-receiver",
    "expirationDateTime": "2016-01-01T11:23:00.000Z"
}

Überprüfung des Abonnements

Bevor ein neues Abonnement erstellt wird, sendet Microsoft Graph eine Anforderung an die URL, die in der Anforderung zum Erstellen eines neuen Abonnements enthalten ist. Ihr Dienst muss auf diese Anforderung durch Zurückgeben des Überprüfungsschlüssels antworten.

Wenn der Dienst die Anforderung auf diese Weise nicht überprüfen kann, wird das Abonnement nicht erstellt.

Weitere Informationen finden Sie unter Behandeln von Webhook-Überprüfungsanfragen.

Fehlerantworten

Weitere Informationen dazu, wie Fehler zurückgegeben werden, finden Sie unter Fehlerantworten.