Registrar endpoint de webhook
Registra un endpoint de webhook que recibe las entregas de eventos del plano de control. El secreto provisto se cifra en reposo con AES-256-GCM. El arreglo eventTypes es obligatorio y debe contener constantes canónicas de eventos del plano de control (str.operation., str.readiness., str.certificate., str.approval.). Idempotente: reenviar la misma clave X-Idempotency con el mismo cuerpo devuelve la respuesta en caché.
Autorizaciones
JWT bearer token issued by the identity provider.
Encabezados
Idempotency key (canonical).
Idempotency key (legacy alias).
Idempotency key TTL in seconds (overrides the configured default).
"86400"
Cuerpo
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.

