Partager via

Créer un abonnement

  • Article

Découvrez comment vous abonner à une application de détection pour recevoir des notifications en cas de changement des données.

Autorisations

L’une des autorisations suivantes est requise pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Déléguée (compte Microsoft personnel) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All
Application Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

Requête HTTP

POST /subscriptions

Réponse

En cas de réussite, cette méthode renvoie le code de réponse 201 Created et un objet abonnement dans le corps de la réponse.

Exemple

Demande

Voici un exemple de demande pour envoyer une notification quand le contenu du lecteur de l’utilisateur change.

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"
}

Réponse

Si l’abonnement est ajouté, une réponse 201 Created contenant l’objet d’abonnement nouvellement créé est renvoyée.

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"
}

Validation de l’abonnement

Avant la création d’un abonnement, Microsoft Graph envoie une demande à l’URL fournie dans la demande pour créer un abonnement. Votre service doit répondre à cette demande en renvoyant le jeton de validation.

Si votre service ne parvient pas à valider la demande de cette façon, l’abonnement n’est pas créé.

Consultez la rubrique Gestion des demandes de validation de webhooks pour plus d’informations.

Réponses d’erreur

Pour plus d’informations sur la façon dont les erreurs sont renvoyées, voir Réponses d’erreur.