Webhooks

Rotacionar segredo de assinatura

Gera um segredo novo e mantém o anterior válido por overlapHours (0 a 72, padrão 24). Durante a janela, cada entrega vai assinada com os dois segredos — troque o seu lado no seu ritmo, sem perder entrega. overlapHours: 0 invalida o anterior imediatamente.

Uma nova rotação dentro de uma janela aberta descarta o segredo mais antigo.

previousSecretExpiresAt vem em UTC, com offset explícito no JSON — ver a mesma observação em Consultar segredo de assinatura.

post/v1/webhooks/secret/rotate

Request

  • Base URL: https://api.spedy.com.br (the document declares no server; this is the origin it was published from)
  • URL: https://api.spedy.com.br/v1/webhooks/secret/rotate
  • Auth: API key in header X-Api-Key

Request body

overlapHoursinteger nullable

Horas em que o segredo anterior continua valido apos a troca. Aceita de 0 a 72; quando omitido, aplica 24. Zero invalida o anterior imediatamente.

Response

OK

secretstring nullable

Segredo novo em claro, no formato whsec_ + base64 de 24 bytes.

previousSecretExpiresAtstring date-time nullable

Fim da janela de rotacao, em UTC. Null quando a troca foi imediata.

Changes

No recorded changes to this operation across all 1 revision of this API.