Поделиться через

Создание подписки

  • Статья

Создает подписку на приложение прослушивателя для получения уведомлений при изменении данных.

Разрешения

Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.

Тип разрешения Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Делегированные (личная учетная запись Майкрософт) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All
Для приложений Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

HTTP-запрос

POST /subscriptions

Отклик

В случае успеха этот метод возвращает код отклика 201 Created и объект subscription в теле отклика.

Пример

Запрос

Ниже показан пример запроса на отправку уведомления при изменении контента в объекте drive пользователя.

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

Отклик

Если подписка добавлена, будет возвращен отклик 201 Created, включающий вновь созданный объект подписки.

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

Проверка подписки

Перед созданием подписки Microsoft Graph отправит запрос на URL-адрес, указанный в запросе на создание подписки. Ваша служба должна ответить на этот запрос, возвратив ключ проверки.

Если ваша служба не проверит запрос таким способом, подписка не будет создана.

Подробные сведения см. в разделе, посвященном обработке запросов на проверку веб-перехватчиков.

Ответы с ошибками

Дополнительные сведения о возвращении ошибок см. в статье Ответы с ошибками.