Rotacionar o segredo
Substitua o segredo de assinatura de um webhook.
Solicite um novo segredo para o mesmo cadastro e atualize o receptor.
Guarde o valor retornado em um cofre de segredos; as consultas de
configuração não o recuperam. O período de transição permite atualizar
o receptor antes de os envios passarem a usar somente o segredo novo.
Se houver suspeita de vazamento, use grace_period_seconds: 0 para substituir
o segredo imediatamente, mesmo durante uma transição em andamento.
Veja Rotacionar o segredo para escolher o período de transição e validar as assinaturas durante a troca.
Parâmetros de caminho
Identificador do webhook, recebido no cadastro ou na listagem.
Até 26 caracteres
Parâmetros do corpo
Período em que o segredo anterior pode continuar assinando envios. Zero gera uma nova assinatura e encerra a validade dos segredos anteriores, inclusive durante uma transição ativa. Requisições já autorizadas ou em andamento podem chegar com a assinatura anterior.
De 0 a 86400
Respostas
Para os erros gerais, consulte Códigos HTTP das respostas.