Registra un webhook

POST

/webhooks

La URL debe ser https y pública (se rechazan hosts que resuelven a IP privada,
loopback o link-local, y URLs con credenciales); se vuelve a validar en cada envío.
Cada evento exige su scope (order.* → orders:read; product.* y
availability.changed → catalog:read), si no 403 insufficient_scope. Los
comodines *, order.*, product.* y availability.* se expanden al registrar y
no incluyen product.stock_changed (opt-in). Máximo 10 por florería.

Autorizaciones

bearerAuth

API key de la florería, con formato rf_live_<prefix>_<secreto>. Se entrega una sola
vez; se envía en cada solicitud como Authorization: Bearer <key>.

Tipo

HTTP (bearer)

Cuerpo de la petición

application/json

{

  

"url": "string",

  

"name": "string",

  

"events": [

  

  

"string"

  

]

}

Respuestas

Webhook creado.

Content-Type

application/json

{

  

"error": false,

  

"webhook": {

  

  

"id": 0,

  

  

"name": "string",

  

  

"url": "string",

  

  

"events": [

  

  

  

"string"

  

  

],

  

  

"is_active": true,

  

  

"consecutive_failures": 0,

  

  

"disabled_by_failures": true,

  

  

"disabled_reason": "string",

  

  

"disabled_at": "string",

  

  

"last_delivery_at": "string",

  

  

"created_at": "string",

  

  

"updated_at": "string",

  

  

"secret": "string"

  

}

}

POST

/webhooks

Ejemplos