Crear un webhook
Endpoint POST /webhooks de la API de Proteside: parámetros, cuerpo de la solicitud, respuestas y ejemplos de código.
Crea un canal de notificación de tipo webhook (formato json), slack o teams. Si se omite secret, se genera uno; se devuelve una sola vez en esta respuesta. Las entregas se firman con X-Proteside-Signature: t=<unix>,v1=<hex hmac_sha256(secret, t + "." + rawBody)> y se reintentan 3 veces (1 min, 10 min, 60 min).
bearerAuthAutorizaciónBearer <token>Token de API creado en Ajustes → API. Los alcances están vinculados al token; cada operación indica el alcance requerido en x-scope.
org_id?stringSolo socios (orgs:manage): actúa sobre esta organización hija. También se puede enviar como org_id en cuerpos JSON.
uuidIdempotency-Key?stringReproduce la respuesta original durante 24 h
1 <= length <= 255application/json- body
url*stringSolo https
urisecret?stringOmítelo para que se genere uno
16 <= length <= 256format?string"json""json""slack""teams"name?stringlength <= 120store_id?stringuuidevents?array<>|nullmin_severity?string"high""critical""high""medium""low""info"active?booleantrueWebhook con secret que se muestra una sola vez
application/json- response
id?stringuuidorg_id?stringuuidstore_id?|null = toda la organización
uuidtype?string"webhook""slack""teams"name?stringurl?|uriformat?string"json""slack""teams"has_secret?booleanevents?array<>|null = todos los eventos
min_severity?string"critical""high""medium""low""info"active?booleanlast_used_at?|date-timecreated_at?stringdate-timeupdated_at?stringdate-timesecret?stringSe muestra una sola vez
secret_generated?booleancurl -X POST "https://example.com/webhooks" \ -H "Content-Type: application/json" \ -d '{ "url": "https://ops.partner.example/hooks/proteside", "format": "json", "events": [ "alert.created", "alert.resolved", "report.ready" ], "min_severity": "high" }'{ "id": "a9b8c7d6-0000-4111-8222-333344445555", "org_id": "7f3c1e2a-0b4d-4c8e-9f10-2a3b4c5d6e7f", "store_id": null, "type": "webhook", "name": "Webhook · ops.partner.example", "url": "https://ops.partner.example/hooks/proteside", "format": "json", "has_secret": true, "events": [ "alert.created", "alert.resolved", "report.ready" ], "min_severity": "high", "active": true, "last_used_at": null, "created_at": "2026-09-27T10:20:00.000Z", "updated_at": "2026-09-27T10:20:00.000Z", "secret": "whsec_YOUR_SECRET", "secret_generated": true}Programar informes PCI recurrentes para una tienda POST
Endpoint POST /reports/pci/schedule de la API de Proteside: parámetros, cuerpo de la solicitud, respuestas y ejemplos de código.
Eliminar un webhook DELETE
Endpoint DELETE /webhooks/{id} de la API de Proteside: parámetros, cuerpo de la solicitud, respuestas y ejemplos de código.