Webhooks

Rotar el secreto de firma

POST
/v1/webhook-endpoints/{id}/rotate-secret

Crea un secreto nuevo, que solo se muestra en esta respuesta. Mientras dure el traslape, cada entrega lleva dos firmas, una por secreto, así que puedes cambiar el tuyo sin perder ninguna.

Autorización

AutorizaciónBearer <tu clave API>

Tu clave API: fb_sandbox_… emite en Sandbox, fb_test_… en test, el servicio de pruebas de la autoridad tributaria, y fb_live_… en live, su producción.

En: header

Parámetros de ruta

id*string
Formatouuid

Cuerpo de la solicitud

application/json

Tipos de TypeScript

Usa el tipo request body en TypeScript.

expires_in_hours?integer

Cuántas horas sigue firmando el secreto anterior junto al nuevo, de 0 a 72. Con 0 deja de valer enseguida: úsalo si se filtró.

Rango0 <= value <= 72
Por defecto24

Cuerpo de la respuesta

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/v1/webhook-endpoints/497f6eca-6276-4993-bfeb-53cbbbba6f08/rotate-secret" \  -H "Content-Type: application/json" \  -d '{}'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "object": "webhook_endpoint",  "environment": "sandbox",  "url": "http://example.com",  "events": [    "*"  ],  "disabled": true,  "secret_hint": "string",  "previous_secret_expires_at": "2019-08-24T14:15:22Z",  "deliveries_24h": 0,  "failed_24h": 0,  "failing_since": "2019-08-24T14:15:22Z",  "created_at": "2019-08-24T14:15:22Z",  "secret": "string"}