Abrufen von AbonnementsGet subscriptions

Ruft ein oder mehrere Webhook-Abonnements in einer SharePoint-Liste ab.Gets one or more webhook subscriptions on a SharePoint list.

BerechtigungenPermissions

Abrufen eines einzelnen AbonnementsGet a single subscription

Die Anwendung muss mindestens Bearbeitenberechtigungen für die SharePoint-Liste haben, aus der das Abonnement abgerufen wird.The application must have at least edit permissions to the SharePoint list where the subscription will be retrieved.

Wenn es sich bei Ihrer Anwendung um eine Microsoft Azure Active Directory (Azure AD)-Anwendung handeltIf your application is a Microsoft Azure Active Directory (Azure AD) application

Sie müssen der Azure AD-Anwendung die in der folgenden Tabelle angegebenen Berechtigungen erteilen. Ein Abonnement kann nur von der Azure AD-Anwendung, die es erstellt hat, abgerufen werden.You must grant the Azure AD application the permissions specified in the following table. A subscription can only be retrieved by the Azure AD application that created it.

AnwendungApplication BerechtigungPermission
Office 365 SharePoint OnlineOffice 365 SharePoint Online Lese-/Schreibzugriff auf Elemente und Listen in allen Websitesammlungen.Read and write items and lists in all site collections.

Wenn es sich bei Ihrer Anwendung um ein SharePoint-Add-In handeltIf your application is a SharePoint Add-in

Sie müssen dem SharePoint-Add-In mindestens die folgenden Berechtigungen erteilen.You must grant the SharePoint Add-in the following permission(s) or higher. Ein Abonnement kann nur von dem SharePoint-Add-In, das es erstellt hat, abgerufen werden.A subscription can only be retrieved by the SharePoint Add-in that created it.

UmfangScope BerechtigungenPermission rights
AuflistenList VerwaltenManage

Abrufen aller AbonnementsGet all subscriptions

Die Anwendung muss mindestens Berechtigungen zum Verwalten von Listen für die SharePoint-Liste haben, aus der das Abonnement abgerufen wird.The application must have manage list permissions to the SharePoint list where the subscription will be retrieved.

Wenn die Anwendung eine Azure AD-Anwendung istIf your application is an Azure AD application

Sie müssen der Azure AD-App die in der folgenden Tabelle angegebenen Berechtigungen erteilen.You must grant the Azure AD app the permissions specified in the following table.

AnwendungApplication BerechtigungPermission
Office 365 SharePoint OnlineOffice 365 SharePoint Online Sie benötigen Vollzugriff auf alle Websitesammlungen.Have full control of all site collections.

Wenn es sich bei Ihrer Anwendung um ein SharePoint-Add-In handeltIf your application is a SharePoint Add-in

Sie müssen dem SharePoint-Add-In mindestens die folgenden Berechtigungen erteilen.You must grant the SharePoint Add-in the following permission(s) or higher.

UmfangScope BerechtigungenPermission rights
AuflistenList VollzugriffFull control

HTTP-AnforderungHTTP request

Abrufen eines einzelnen AbonnementsGet a single subscription

Listen-WebhookList webhook

GET _api/web/lists('list-id')/subscriptions('id')
BeispielExample
GET _api/web/lists('5C77031A-9621-4DFC-BB5D-57803A94E91D')/subscriptions('6D77031A-2345-5GRT-BV3D-55234B56FR43')

AnforderungstextRequest body

Geben Sie für diese Methode keinen Anforderungstext an.Do not supply a request body for this method.

AntwortResponse

Dies gibt das Abonnement für die Anzeige durch die aufrufende Anwendung zurück.This returns the subscription viewable by the calling application.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "odata.metadata": "https://contoso.sharepoint.com/_api/$metadata#SP.ApiData.Subscriptions/@Element",
  "odata.type": "Microsoft.SharePoint.Webhooks.Subscription",
  "odata.id": "https://contoso.sharepoint.com/_api/web/lists('5C77031A-9621-4DFC-BB5D-57803A94E91D')/subscriptions('a8e6d5e6-9f7f-497a-b97f-8ffe8f559dc7')",
  "odata.editLink": "web/lists('5C77031A-9621-4DFC-BB5D-57803A94E91D')/subscriptions('a8e6d5e6-9f7f-497a-b97f-8ffe8f559dc7')",
  "expirationDateTime": "2016-04-30T16:17:57Z",
  "id": "a8e6d5e6-9f7f-497a-b97f-8ffe8f559dc7",
  "notificationUrl": "https://contoso.azurewebistes.net/api/webhook/handlerequest",
  "resource": "5c77031a-9621-4dfc-bb5d-57803a94e91d"
}

Abrufen aller AbonnementsGet all subscriptions

Listen-WebhookList webhook

GET _api/web/lists('list-id')/subscriptions
BeispielExample
GET _api/web/lists('5C77031A-9621-4DFC-BB5D-57803A94E91D')/subscriptions

AnforderungstextRequest body

Geben Sie für diese Methode keinen Anforderungstext an.Do not supply a request body for this method.

AntwortResponse

Dies gibt eine Auflistung aller Abonnements in einer SharePoint-Ressource zurück.This returns a collection of all subscriptions on a SharePoint resource.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "odata.metadata": "https://a830edad9050849295j16032914.sharepoint.com/_api/$metadata#SP.ApiData.Subscriptions",
  "value": [
    {
      "odata.type": "Microsoft.SharePoint.Webhooks.Subscription",
      "odata.id": "https://contoso.sharepoint.com/_api/Microsoft.SharePoint.Webhooks.Subscriptionc3175b9c-1491-454f-b5da-980431e36146",
      "odata.editLink": "Microsoft.SharePoint.Webhooks.Subscriptionc3175b9c-1491-454f-b5da-980431e36146",
      "clientState": "{A0A354EC-97D4-4D83-9DDB-144077ADB449}",
      "expirationDateTime": "2016-04-30T16:17:57Z",
      "id": "a8e6d5e6-9f7f-497a-b97f-8ffe8f559dc7",
      "notificationUrl": "https://contoso.azurewebsites.net/api/webhook/handlerequest",
      "resource": "5c77031a-9621-4dfc-bb5d-57803a94e91d"
    }
  ]
}

Siehe auchSee also