Compartir a través de

Crear suscripción

Suscripción a una aplicación de escucha para recibir notificaciones cuando cambian los datos.

Permisos

Se requiere uno de los permisos siguientes para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Delegado (cuenta personal de Microsoft) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All
Aplicación Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

Solicitud HTTP

POST /subscriptions

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 201 Created y un objeto de suscripción en el cuerpo de la respuesta.

Ejemplo

Solicitud

Este es un ejemplo de solicitud para enviar una notificación cuando cambia el contenido de la unidad de un usuario.

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

Respuesta

Si se ha agregado la suscripción, entonces se devuelve una respuesta de 201 Created que incluye el objeto de suscripción recién creado.

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

Validación de suscripciones

Antes de que se cree una suscripción, Microsoft Graph enviará una solicitud a la URL proporcionada en la solicitud para crear una suscripción. Su servicio debe responder a esta solicitud devolviendo la clave de validación.

Si el servicio produce un error al validar la solicitud de esta manera, la suscripción no se creará.

Vea handling webhook validation requests (Controlar las solicitudes de validación de webhooks) para obtener más información.

Respuestas de error

Vea Respuestas de error para obtener más información sobre la manera en que se devuelven los errores.

  • Last updated on