Partager via

Mise à jour d’un abonnement

  • Article

Met à jour un abonnement de webhook sur une liste SharePoint.

Autorisations

L’application doit au moins disposer d’autorisations de modification sur la liste SharePoint où l’abonnement sera mis à jour.

Si votre application est une application Microsoft Azure Active Directory (Azure AD) :

Vous devez accorder à l’application Azure AD les autorisations définies dans le tableau suivant. Un abonnement peut uniquement être mis à jour par l’application Azure Active Directory qui l’a créé.

Application Autorisation
Office 365 SharePoint Online Lire et écrire des éléments et des listes dans toutes les collections de sites.

Si votre application est un complément SharePoint :

Vous devez accorder au complément SharePoint les autorisations suivantes ou des autorisations supérieures : Un abonnement peut uniquement être mis à jour par le complément SharePoint qui l’a créé.

Domaine d’application Droits d’autorisation
Répertorier Gérer

Requête HTTP

PATCH _api/web/lists('list-id')/subscriptions('id')

Exemple

PATCH _api/web/lists('5C77031A-9621-4DFC-BB5D-57803A94E91D')/subscriptions('6D77031A-2345-5GRT-BV3D-55234B56FR43')
Content-Type: application/json

{
  "notificationUrl": "https://contoso.azurewebsites.net/api/v2/webhook-receiver",
  "expirationDateTime": "2016-01-03T11:23:00.000Z"
}

Corps de la demande

Inclure les propriétés suivantes dans le corps de la requête.

Nom Type Description
notificationUrl chaîne URL du service auquel envoyer des notifications.
expirationDateTime date Date à laquelle la notification arrivera à expiration et sera supprimée.
clientState string Facultatif. Chaîne opaque renvoyée au client pour toutes les notifications.
Vous pouvez utiliser cette chaîne pour valider les notifications ou marquer différents abonnements.

Réponse

Si l’abonnement est trouvé et mis à jour, une réponse 204 No Content est renvoyée.

Exemple

HTTP/1.1 204 No Content

Voir aussi