Os administradores da organização podem gerenciar webhooks para qualquer camada de feição hospedada qualificada, exibição de camada de feição hospedada ou tabela hospedada na organização.
A infraestrutura para dar suporte a webhooks é configurada fora do ArcGIS. Para obter informações sobre o que você deve configurar antes de criar um webhook e saber quais privilégios são necessários para gerenciar webhooks, consulte Webhooks no ArcGIS Online.
O item deve ter a configuração de edição Acompanhe as alterações nos dados (adicionar, atualizar, excluir feições) habilitada antes que você possa criar ou gerenciar um webhook para ele.
Gerenciar webhooks
O gerenciamento de um webhook associado a uma camada de feição hospedada, exibição de camada de feição hospedada ou tabela hospedada inclui o seguinte:
- Desativar ou ativar o webhook—quando um webhook está inativo, ele não dispara quando os eventos de disparo definidos para ele ocorrem. Você pode desativar todos os webhooks em uma camada temporariamente enquanto executa atualizações automatizadas para evitar encher sua caixa de entrada com mensagens. Ou você pode desativar temporariamente um webhook que dispara para todos os eventos possíveis e deixar outro webhook ativo que dispara em um único gatilho para permitir que você se concentre temporariamente naquele evento.
- Editar o webhook—você pode alterar as configurações do webhook. Por exemplo, é possível adicionar uma chave secreta ou modificar os gatilhos de eventos que acionam o disparo do webhook.
- Excluir o webhook—se um webhook não for mais necessário, você pode excluí-lo.
Anotação:
Os webhooks são imediatamente excluídos. Eles não vão para a lixeira de reciclagem.
Para gerenciar qualquer webhook na organização, conclua as seguintes etapas:
- Entre na organização como administrador da organização.
Conforme observado acima, consulte Webhooks no ArcGIS Online para os privilégios necessários.
- Clique em Organização > Configurações > Webhooks.
- Execute uma das seguintes tarefas de gerenciamento:
- Para desativar o webhook, desative o botão de alternar ao lado do nome do webhook.
- Para ativar o webhook, ative o botão de alternar ao lado do nome do webhook.
- Para editar as configurações de um webhook, clique no botão Opções
ao lado do nome do webhook e clique em Editar. Altere o nome, os eventos, a URL do receptor do webhook ou a chave secreta do webhook e clique em Atualizar webhook. - Para excluir um webhook, clique no botão Opções ao lado do nome do webhook e clique em Excluir. Quando solicitado a confirmar, clique em Excluir.
- Repita a etapa anterior para quaisquer outros webhooks que você precise gerenciar.
Definir configurações avançadas
As configurações avançadas aplicadas aos webhooks em sua organização permitem personalizar ainda mais seu desempenho.
As configurações de webhook avançadas se aplicam a todos os webhooks na organização. Você pode definir as seguintes configurações avançadas:
- Número de tentativas de entrega—Esse valor especifica o número de tentativas que serão feitas para entregar as cargas úteis do webhook. Por padrão, o sistema tentará entregar cargas úteis uma vez. O valor das tentativas deve ser um número inteiro entre 1 e 5.
- Tempo limite de notificação—Este valor especifica o tempo, em segundos, entre cada tentativa de entrega de carga útil. Por padrão, o sistema tentará entregar outra carga útil após 10 segundos se a tentativa anterior falhar, até que o número de tentativas especificado para a configuração Número de tentativas de entrega seja atingido. O valor do tempo limite de notificação deve ser um número inteiro entre 1 e 10.
- Número máximo de falhas—Este valor especifica o número de falhas que podem ocorrer durante um número específico de dias antes que o webhook seja desativado. Por padrão, o sistema aceitará 5 falhas. O valor deve ser um número inteiro entre 1 e 10.
- Entre na organização como administrador da organização.
Conforme observado acima, consulte Webhooks no ArcGIS Online para os privilégios necessários.
- Clique em Organização > Configurações > Webhooks.
- Clique em Configurações avançadas.
- Altere os valores das configurações avançadas descritas acima, conforme necessário.
- Clique em Salvar.