Registrar endpoint de webhook
Registra um endpoint de webhook que recebe as entregas de eventos do plano de controle. O segredo fornecido é criptografado em repouso com AES-256-GCM. O array eventTypes é obrigatório e deve conter constantes canônicas de eventos do plano de controle (str.operation., str.readiness., str.certificate., str.approval.). Idempotente: reenviar a mesma chave X-Idempotency com o mesmo corpo retorna a resposta em cache.
Autorizações
JWT bearer token issued by the identity provider.
Cabeçalhos
Idempotency key (canonical).
Idempotency key (legacy alias).
Idempotency key TTL in seconds (overrides the configured default).
"86400"
Corpo
Canonical control-plane event types to subscribe to (str.operation., str.readiness., str.certificate., str.approval.); at least one required.
[
"str.operation.accepted",
"str.operation.received"
]
Shared signing secret (16-512 chars); encrypted at rest with AES-256-GCM and never returned.
"whsec_..."
HTTPS endpoint that receives event deliveries; max 2048 chars and subject to an SSRF check.
"https://example.com/webhooks/str-events"
Whether the endpoint is active and eligible to receive deliveries; defaults to active when omitted.
Arbitrary client-defined key/value metadata stored with the endpoint.

