Webhooks

Consultar segredo de assinatura

Devolve o segredo usado para assinar as entregas de webhook da conta — o mesmo valor para todos os webhooks configurados. Use-o para verificar o header webhook-signature com uma biblioteca do padrão Standard Webhooks.

O segredo pode ser consultado quantas vezes for preciso; não é revelado uma única vez. Durante uma janela de rotação, previousSecretExpiresAt informa até quando o segredo anterior continua sendo aceito.

createdAt e previousSecretExpiresAt são os únicos campos desta API em UTC, com offset explícito no JSON (ex.: 2026-08-17T15:11:50+00:00) — o resto da API usa hora local de São Paulo. Não confunda um com o outro ao calcular a janela de sobreposição.

get/v1/webhooks/secret

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
  • Auth: API key in header X-Api-Key

Response

OK

secretstring nullable

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

createdAtstring date-time

Data de criacao do segredo, em UTC.

previousSecretExpiresAtstring date-time nullable

Fim da janela de rotacao, em UTC. Null quando nao ha rotacao em andamento.

Changes

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