Mise à jour d’un abonnement

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

Autorisations

Le tableau d’autorisations des compléments SharePoint ci-dessous concerne uniquement les références héritées. Utiliser l’authentification Microsoft Entra prise en charge pour les webhooks SharePoint Online.

Importante

Les compléments SharePoint ont atteint leur fin de vie dans SharePoint Online le 2 avril 2026. Les compléments hébergés par SharePoint et par le fournisseur sont mis hors service et ne fonctionnent plus dans SharePoint Online, y compris les clouds publics. Les instructions de développement, de déploiement et d’utilisation des compléments sont conservées à titre de référence historique et pour les scénarios SharePoint Server applicables, et non pour les nouvelles solutions SharePoint Online.

Les compléments SharePoint Server déployés via un catalogue d’applications local ne sont pas mis hors service par cette modification. L’acquisition de compléments SharePoint sur la place de marché publique a pris fin le 2 avril 2026 pour SharePoint Server.

Ce retrait ne met pas hors service les API REST SHAREPoint, CSOM, JSOM ou SharePoint Framework (SPFx). Pour SharePoint Online, utilisez SPFx pour les extensions d’interface utilisateur et Microsoft Entra ID pour l’authentification auprès des applications externes. Consultez l’annonce de mise hors service et les conseils sur la migration des compléments.

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

  • Dernière mise à jour :