Compartilhar via

Atualizar uma assinatura

  • Artigo

Atualiza uma assinatura de webhook em uma lista do SharePoint.

Permissões

O aplicativo deve ter pelo menos permissões de edição para a lista do SharePoint em que a assinatura será atualizada.

Se o aplicativo for um aplicativo do Microsoft Azure Active Directory (Azure AD)

Você deve conceder ao aplicativo do Azure AD as permissões especificadas na tabela a seguir. Uma assinatura só pode ser atualizada pelo aplicativo do Azure AD que a criou.

Aplicativo Permissão
Office 365 SharePoint Online Ler e gravar listas e itens em todos os conjuntos de sites.

Se o aplicativo for um suplemento do SharePoint

Você deve conceder ao suplemento do SharePoint as permissões a seguir ou superiores. Uma assinatura só pode ser atualizada pelo suplemento do SharePoint que a criou.

Escopo Direitos de permissão
Listar Gerenciar

Solicitação HTTP

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

Exemplo

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

Corpo da solicitação

Inclua as propriedades a seguir no corpo da solicitação.

Nome Tipo Descrição
notificationUrl cadeia de caracteres A URL de serviço à qual enviar notificações.
expirationDateTime data A data na notificação expirará e será excluída.
clientState string Opcional. Cadeia de caracteres opaca passada ao cliente em todas as notificações.
Você pode usar isso para validar notificações ou marcar assinaturas diferentes.

Resposta

Se a assinatura for encontrada e atualizada com êxito, uma resposta 204 No Content será retornada.

Exemplo

HTTP/1.1 204 No Content

Confira também