Alertas y webhooks
Lee las alertas, ajusta las reglas que las crean y registra webhooks que las reciben, firmados y con reintentos.
En esta página
- El objeto alerta
- El objeto webhook
- Qué recibe un webhook
- Comprueba la firma
- Toma el cuerpo crudo
- Calcula la firma
- Compara, y revisa la hora
- Reintentos
- Listar alertas
- Traer una alerta
- Marcar una alerta como vista
- Listar las reglas de alerta
- Actualizar una regla de alerta
- Listar webhooks
- Crear un webhook
- Traer un webhook
- Actualizar un webhook
- Borrar un webhook
- Listar las entregas de un webhook
- Enviar un evento de prueba
Una alerta es un registro que dice que algo necesita a una persona: un problema nuevo, un problema que volvió, tu app sin responder. El motor siempre registra las alertas. Lo que pasa después depende de dónde corres:
| Motor de SypniaCódigo abierto, en tu propia infraestructura | Sypnia CloudServicio pago, con un plan gratis | |
|---|---|---|
| Registradas; se listan por API, MCP y CLI | Sí | Sí |
| Enviadas a tus webhooks | Sí | Sí |
| Correo | No. El despliegue por defecto no tiene cómo enviar correos. Mira la guía | Sí |
| Mostradas a las personas | En la Consola | En la app |
Las alertas se crean solo para el entorno production, salvo que cambies los environments de una regla. No hay integración con apps de chat: un webhook es la forma de enviar una alerta a cualquier otro lado.
Un motor alojado por ti también puede enviar cada alerta de cada proyecto a una URL, sin ninguna llamada a esta API: define SYPNIA_ALERT_WEBHOOK_URL. Mira la referencia de configuración.
El objeto alerta
Campos
-
idstring opcionalalt_…. -
kindstring opcionalQué regla la creó. Mira las reglas de alerta.
-
titlestring opcionalLa alerta en una línea, lista para enviársela a una persona.
-
environmentstring opcional -
subjectobject opcionalDe qué trata la alerta.
-
subject.typestringUno de:
problem,uptime_check,page,api_route,project. -
subject.idstringEl id del problema o de la comprobación, o la ruta.
-
subject.slugstringSolo en problemas.
-
created_attimestamp opcional -
acknowledged_attimestamp o null opcional -
acknowledged_bystring o null opcionalQuién la marcó como vista, escrito igual que
resolved_byen un problema. -
urlURL opcionalDónde mirar, en la app o en la Consola.
El objeto webhook
Campos
-
idstring opcionalwhk_…. -
urlURL opcional -
eventslista de string opcional -
enabledboolean opcional -
created_attimestamp opcional -
last_deliveryobject o null opcionalLa última entrega y cómo salió.
-
disabled_reasonstring o null opcionalfailingcuando el motor lo apagó después de 3 días de entregas fallidas.
Qué recibe un webhook
Cada evento es un POST a tu URL con un cuerpo JSON.
| Tipo de evento | Cuándo |
|---|---|
alert.created | Se creó una alerta. Es el que se reenvía a las personas |
problem.created | Un problema se vio por primera vez, en cualquier entorno |
problem.analyzed | El agente terminó un análisis. Viene en data.problem.analysis |
problem.status_changed | Un problema se resolvió, se reabrió, se ignoró o volvió |
problem.pull_request_opened | Solo en Sypnia Cloud: Sypnia abrió un pull request |
ping | Creaste el webhook, o pediste una prueba |
Encabezados de una entrega
POST /hooks/sypnia HTTP/1.1
Content-Type: application/json
User-Agent: Sypnia-Webhooks/1.0
Sypnia-Event: alert.created
Sypnia-Delivery: dlv_2s4d6f8g0h1j
Sypnia-Attempt: 1
Sypnia-Signature: t=1773306783,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bdCuerpo de una entrega `alert.created`
{
"id": "evt_7m3n9b5v1c8x",
"type": "alert.created",
"created_at": "2026-03-12T09:13:02Z",
"project": { "id": "prj_5k2m9x4q7w1z", "slug": "shop", "name": "Shop" },
"data": {
"alert": {
"id": "alt_6w2e8r4t1y9u",
"kind": "problem.new",
"title": "New problem: 1 person tried to pay and could not.",
"environment": "production",
"subject": { "type": "problem", "id": "prb_8f3k2m9x4q7w", "slug": "pay-button-does-nothing" },
"created_at": "2026-03-12T09:13:02Z",
"acknowledged_at": null,
"acknowledged_by": null,
"url": "https://app.sypnia.com/shop/problems/pay-button-does-nothing"
},
"problem": {
"id": "prb_8f3k2m9x4q7w",
"slug": "pay-button-does-nothing",
"status": "open",
"title": "createPayment answered 400 in POST /api/checkout",
"sentence": null,
"people": 1,
"sessions": 1,
"first_seen": "2026-03-12T09:12:04Z",
"url": "https://app.sypnia.com/shop/problems/pay-button-does-nothing"
}
}
}Campos de toda entrega
-
idstringEl id del evento,
evt_…. Es el mismo en cada reintento del mismo evento: guárdalo e ignora un id que ya atendiste. -
typestringEl tipo de evento, como en la tabla de arriba. También viene en el encabezado
Sypnia-Event. -
created_attimestampCuándo ocurrió el evento, no cuándo se envió.
-
projectobjectEl proyecto:
id,slug,name. -
dataobjectPara
alert.created:alert, másproblemocheckcuando la alerta trata de uno. Para los tiposproblem.*:problem, en la forma corta de arriba, másprevious_statusparaproblem.status_changed. Paraping: vacío. Una alerta enviada en los primeros 2 minutos de un problema puede traersentenceennull: la alerta no espera al agente más que eso.
Comprueba la firma
Cualquiera que conozca tu URL le puede enviar peticiones. Comprueba que una entrega viene de Sypnia antes de actuar.
Sypnia-Signature trae una marca de tiempo t (segundos) y una firma v1. La firma es el HMAC-SHA256, en hexadecimal, de la marca de tiempo, un punto y el cuerpo crudo, con el secreto del webhook (whsec_…) como llave.
Node.js
import { createHmac, timingSafeEqual } from 'node:crypto';
export function isFromSypnia(rawBody, header, secret) {
const parts = Object.fromEntries(header.split(',').map((p) => p.split('=')));
if (!parts.t || !parts.v1) return false;
if (Math.abs(Date.now() / 1000 - Number(parts.t)) > 300) return false;
const expected = createHmac('sha256', secret).update(`${parts.t}.${rawBody}`).digest('hex');
const a = Buffer.from(expected);
const b = Buffer.from(parts.v1);
return a.length === b.length && timingSafeEqual(a, b);
}Python
import hashlib, hmac, time
def is_from_sypnia(raw_body: bytes, header: str, secret: str) -> bool:
parts = dict(p.split("=", 1) for p in header.split(","))
if "t" not in parts or "v1" not in parts:
return False
if abs(time.time() - int(parts["t"])) > 300:
return False
signed = parts["t"].encode() + b"." + raw_body
expected = hmac.new(secret.encode(), signed, hashlib.sha256).hexdigest()
return hmac.compare_digest(expected, parts["v1"])Reintentos
Una entrega sale bien cuando tu receptor responde cualquier 2xx en menos de 10 segundos. Responde primero y haz después el trabajo lento.
Cualquier otra cosa se reintenta, con el mismo id evt_… y un Sypnia-Attempt mayor:
| Intento | Cuándo |
|---|---|
| 1 | De inmediato |
| 2 | 1 minuto después |
| 3 | 5 minutos después |
| 4 | 30 minutos después |
| 5 | 2 horas después |
| 6 | 6 horas después |
| 7 | 12 horas después |
Después de la séptima falla la entrega queda en failed y no se intenta más. Cuando todas las entregas a un webhook fallan durante 3 días, el motor apaga el webhook (disabled_reason queda en failing) y crea una alerta engine.failing. Enciéndelo otra vez con PATCH.
Las entregas pueden llegar en desorden y, rara vez, dos veces. Usa el id del evento para ignorar duplicados y created_at para ordenar.
Listar alertas
/v1/alerts MotorNube Las alertas creadas en el rango de tiempo, la más nueva primero.
Parámetros de consulta
-
projectstring opcionalEl id o el slug del proyecto. Solo hace falta con una credencial que ve varios proyectos (el token raíz). Con un token de API se ignora, salvo que nombre otro proyecto, que es
403. -
kindstring opcionalSolo alertas de este tipo. Mira la lista en las reglas de alerta.
-
acknowledgedboolean opcionalfalsedevuelve solo las alertas que nadie ha marcado como vistas. -
sincestring opcionalSolo alertas creadas después de este momento.
Por defecto:
7d -
untilstring opcionalFin del rango de tiempo. Una fecha ISO 8601 o un valor relativo. Por defecto, ahora.
-
limitinteger, 1 a 200 opcionalMáximo de elementos que se devuelven.
Por defecto:
50 -
cursorstring opcionalEl
next_cursorde la página anterior. Deja iguales todos los demás parámetros.
Petición
curl "https://api.sypnia.com/v1/alerts?acknowledged=false" \
-H "Authorization: Bearer $SYPNIA_API_TOKEN"Respuesta200
{
"data": [
{
"id": "alt_6w2e8r4t1y9u",
"kind": "problem.new",
"title": "New problem: 1 person tried to pay and could not.",
"environment": "production",
"subject": {
"type": "problem",
"id": "prb_8f3k2m9x4q7w",
"slug": "pay-button-does-nothing"
},
"created_at": "2026-03-12T09:13:02Z",
"acknowledged_at": null,
"acknowledged_by": null,
"url": "https://app.sypnia.com/shop/problems/pay-button-does-nothing"
}
],
"next_cursor": null
}Traer una alerta
/v1/alerts/{alert_id} MotorNube Una alerta.
Parámetros de ruta
-
alert_idstring obligatorioEl id de la alerta (
alt_…).
Parámetros de consulta
-
projectstring opcionalEl id o el slug del proyecto. Solo hace falta con una credencial que ve varios proyectos (el token raíz). Con un token de API se ignora, salvo que nombre otro proyecto, que es
403.
Petición
curl "https://api.sypnia.com/v1/alerts/alt_6w2e8r4t1y9u" \
-H "Authorization: Bearer $SYPNIA_API_TOKEN"Respuesta200
{
"id": "alt_6w2e8r4t1y9u",
"kind": "problem.new",
"title": "New problem: 1 person tried to pay and could not.",
"environment": "production",
"subject": {
"type": "problem",
"id": "prb_8f3k2m9x4q7w",
"slug": "pay-button-does-nothing"
},
"created_at": "2026-03-12T09:13:02Z",
"acknowledged_at": null,
"acknowledged_by": null,
"url": "https://app.sypnia.com/shop/problems/pay-button-does-nothing"
}Errores
- 404
not_foundNinguna alerta del proyecto tiene este id.
Marcar una alerta como vista
/v1/alerts/{alert_id}/acknowledge MotorNube Registra que alguien vio la alerta. No cambia nada más: el problema o la comprobación que hay detrás conserva su estado. Marcarla dos veces responde 200 y conserva la primera marca.
Parámetros de ruta
-
alert_idstring obligatorioEl id de la alerta (
alt_…).
Parámetros de consulta
-
projectstring opcionalEl id o el slug del proyecto. Solo hace falta con una credencial que ve varios proyectos (el token raíz). Con un token de API se ignora, salvo que nombre otro proyecto, que es
403.
Petición
curl -X POST "https://api.sypnia.com/v1/alerts/alt_6w2e8r4t1y9u/acknowledge" \
-H "Authorization: Bearer $SYPNIA_API_TOKEN"Respuesta200
{
"id": "alt_6w2e8r4t1y9u",
"kind": "problem.new",
"title": "New problem: 1 person tried to pay and could not.",
"environment": "production",
"subject": {
"type": "problem",
"id": "prb_8f3k2m9x4q7w",
"slug": "pay-button-does-nothing"
},
"created_at": "2026-03-12T09:13:02Z",
"acknowledged_at": "2026-03-12T10:36:20Z",
"acknowledged_by": "token:Cursor",
"url": "https://app.sypnia.com/shop/problems/pay-button-does-nothing"
}Errores
- 404
not_foundNinguna alerta del proyecto tiene este id.
Listar las reglas de alerta
/v1/alert-rules MotorNube Las reglas que crean alertas. El conjunto es fijo: hay una regla por tipo de alerta, y tú enciendes o apagas cada una y ajustas sus umbrales. No se pueden agregar tipos.
| Tipo | Crea una alerta cuando | Umbrales (por defecto) |
|---|---|---|
problem.new | Un problema se ve por primera vez | Ninguno |
problem.regressed | Un problema resuelto ocurre otra vez | Ninguno |
problem.growing | Un problema abierto llega al doble de las personas que tenía en su última alerta | factor 2, min_people 5 |
uptime.down | Una comprobación falla dos veces seguidas | failures 2 |
uptime.recovered | Una comprobación que estaba caída vuelve a responder | Ninguno |
page.slower | El LCP en p75 de una página en las últimas 24 horas creció frente a los 7 días anteriores | increase_percent 30, min_views 50 |
api.failing | Una ruta de la API responde 5xx o nada con demasiada frecuencia en la última hora | error_rate_percent 2, min_requests 50 |
usage.limit | El proyecto llega a una parte de un límite de uso | percents 80 y 100 |
engine.failing | El procesamiento lleva 30 minutos atrasado, o las entregas de webhooks siguen fallando | Ninguno |
Parámetros de consulta
-
projectstring opcionalEl id o el slug del proyecto. Solo hace falta con una credencial que ve varios proyectos (el token raíz). Con un token de API se ignora, salvo que nombre otro proyecto, que es
403.
Petición
curl "https://api.sypnia.com/v1/alert-rules" \
-H "Authorization: Bearer $SYPNIA_API_TOKEN"Respuesta200
{
"data": [
{
"kind": "problem.new",
"enabled": true,
"environments": [
"production"
],
"thresholds": {}
},
{
"kind": "problem.regressed",
"enabled": true,
"environments": [
"production"
],
"thresholds": {}
},
{
"kind": "problem.growing",
"enabled": true,
"environments": [
"production"
],
"thresholds": {
"factor": 2,
"min_people": 5
}
},
{
"kind": "uptime.down",
"enabled": true,
"environments": [
"production"
],
"thresholds": {
"failures": 2
}
},
{
"kind": "uptime.recovered",
"enabled": true,
"environments": [
"production"
],
"thresholds": {}
},
{
"kind": "page.slower",
"enabled": true,
"environments": [
"production"
],
"thresholds": {
"increase_percent": 30,
"min_views": 50
}
},
{
"kind": "api.failing",
"enabled": true,
"environments": [
"production"
],
"thresholds": {
"error_rate_percent": 2,
"min_requests": 50
}
},
{
"kind": "usage.limit",
"enabled": true,
"environments": [
"production"
],
"thresholds": {
"percents": [
80,
100
]
}
},
{
"kind": "engine.failing",
"enabled": true,
"environments": [
"production"
],
"thresholds": {}
}
]
}Actualizar una regla de alerta
/v1/alert-rules/{kind} MotorNube Enciende o apaga una regla, cambia los entornos que vigila o cambia sus umbrales. Envía solo lo que cambia; los umbrales se mezclan clave por clave.
Parámetros de ruta
-
kindstring obligatorioEl tipo de la regla, por ejemplo
page.slower. Uno de:problem.new,problem.regressed,problem.growing,uptime.down,uptime.recovered,page.slower,api.failing,usage.limit,engine.failing.
Parámetros de consulta
-
projectstring opcionalEl id o el slug del proyecto. Solo hace falta con una credencial que ve varios proyectos (el token raíz). Con un token de API se ignora, salvo que nombre otro proyecto, que es
403.
Cuerpo
-
enabledboolean opcionalfalsedetiene este tipo de alerta. -
environmentslista de string opcionalLos entornos que vigila la regla.
-
thresholdsobject opcionalLos umbrales que cambian, por nombre. Mira la tabla de reglas.
Petición
curl -X PATCH "https://api.sypnia.com/v1/alert-rules/page.slower" \
-H "Authorization: Bearer $SYPNIA_ADMIN_TOKEN" \
-H "Content-Type: application/json" \
-d '{"thresholds": {"increase_percent": 50}}'Respuesta200
{
"kind": "page.slower",
"enabled": true,
"environments": [
"production"
],
"thresholds": {
"increase_percent": 50,
"min_views": 50
}
}Errores
- 400
invalid_requestUn umbral no existe para este tipo o está fuera de rango.
paramlo nombra. - 404
not_foundNinguna regla tiene este tipo.
Listar webhooks
/v1/webhooks MotorNube Los webhooks del proyecto. Los secretos no se muestran.
Parámetros de consulta
-
projectstring opcionalEl id o el slug del proyecto. Solo hace falta con una credencial que ve varios proyectos (el token raíz). Con un token de API se ignora, salvo que nombre otro proyecto, que es
403.
Petición
curl "https://api.sypnia.com/v1/webhooks" \
-H "Authorization: Bearer $SYPNIA_ADMIN_TOKEN"Respuesta200
{
"data": [
{
"id": "whk_4z6x8c2v0b1n",
"url": "https://shop.example.com/hooks/sypnia",
"events": [
"alert.created",
"problem.analyzed"
],
"enabled": true,
"created_at": "2026-02-02T09:25:00Z",
"last_delivery": {
"at": "2026-03-12T10:33:06Z",
"status": "delivered",
"response_status": 200
},
"disabled_reason": null
}
],
"next_cursor": null
}Crear un webhook
/v1/webhooks MotorNube Registra una URL tuya para recibir eventos. El secreto de firma está en secret y se muestra solo en esta respuesta. La URL debe ser https (un motor alojado por ti también acepta http cuando SYPNIA_WEBHOOKS_ALLOW_HTTP es true, para un receptor dentro de tu propia red).
El motor envía un evento ping apenas se crea, para que veas funcionar tu receptor.
Parámetros de consulta
-
projectstring opcionalEl id o el slug del proyecto. Solo hace falta con una credencial que ve varios proyectos (el token raíz). Con un token de API se ignora, salvo que nombre otro proyecto, que es
403.
Encabezados
-
Idempotency-Keystring, hasta 255 caracteres opcionalUn valor tuyo, de 1 a 255 caracteres, que hace que la llamada se pueda repetir sin riesgo. Mira idempotencia.
Cuerpo
-
urlURL, hasta 2,000 caracteres obligatorioA dónde enviar los eventos.
-
eventslista de string opcionalLos tipos de evento que se envían.
problem.pull_request_openedsolo ocurre en Sypnia Cloud. Uno de:alert.created,problem.created,problem.analyzed,problem.status_changed,problem.pull_request_opened.Por defecto:
['alert.created'] -
enabledboolean opcionalfalselo crea en pausa.Por defecto:
true
Petición
curl -X POST "https://api.sypnia.com/v1/webhooks" \
-H "Authorization: Bearer $SYPNIA_ADMIN_TOKEN" \
-H "Content-Type: application/json" \
-d '{"url": "https://shop.example.com/hooks/sypnia", "events": ["alert.created", "problem.analyzed"]}'Respuesta201
{
"id": "whk_4z6x8c2v0b1n",
"url": "https://shop.example.com/hooks/sypnia",
"events": [
"alert.created",
"problem.analyzed"
],
"enabled": true,
"secret": "whsec_Jt5nQ8rV2xZ7cB4mK9pL1dF6hS3gA0wE",
"created_at": "2026-02-02T09:25:00Z",
"last_delivery": null,
"disabled_reason": null
}Errores
- 400
invalid_requestLa URL no es
https, resuelve a una dirección privada (Sypnia Cloud), oeventstiene un tipo desconocido. - 409
limit_reachedEl proyecto ya tiene 10 webhooks.
Traer un webhook
/v1/webhooks/{webhook_id} MotorNube Un webhook, sin su secreto.
Parámetros de ruta
-
webhook_idstring obligatorioEl id del webhook (
whk_…).
Parámetros de consulta
-
projectstring opcionalEl id o el slug del proyecto. Solo hace falta con una credencial que ve varios proyectos (el token raíz). Con un token de API se ignora, salvo que nombre otro proyecto, que es
403.
Petición
curl "https://api.sypnia.com/v1/webhooks/whk_4z6x8c2v0b1n" \
-H "Authorization: Bearer $SYPNIA_ADMIN_TOKEN"Respuesta200
{
"id": "whk_4z6x8c2v0b1n",
"url": "https://shop.example.com/hooks/sypnia",
"events": [
"alert.created",
"problem.analyzed"
],
"enabled": true,
"created_at": "2026-02-02T09:25:00Z",
"last_delivery": {
"at": "2026-03-12T10:33:06Z",
"status": "delivered",
"response_status": 200
},
"disabled_reason": null
}Errores
- 404
not_foundNingún webhook del proyecto tiene este id.
Actualizar un webhook
/v1/webhooks/{webhook_id} MotorNube Cambia la URL, los eventos o enabled. Poner enabled en true en un webhook que el motor apagó reanuda las entregas. Envía rotate_secret en true para recibir un secreto nuevo, que se muestra solo en esta respuesta; el anterior deja de funcionar de inmediato.
Parámetros de ruta
-
webhook_idstring obligatorioEl id del webhook (
whk_…).
Parámetros de consulta
-
projectstring opcionalEl id o el slug del proyecto. Solo hace falta con una credencial que ve varios proyectos (el token raíz). Con un token de API se ignora, salvo que nombre otro proyecto, que es
403.
Cuerpo
-
urlURL, hasta 2,000 caracteres opcionalA dónde enviar los eventos.
-
eventslista de string opcionalLos tipos de evento que se envían. Reemplaza la lista.
-
enabledboolean opcionalfalsepausa las entregas; los eventos que ocurran mientras tanto no se envían después. -
rotate_secretboolean opcionaltruereemplaza el secreto de firma.Por defecto:
false
Petición
curl -X PATCH "https://api.sypnia.com/v1/webhooks/whk_4z6x8c2v0b1n" \
-H "Authorization: Bearer $SYPNIA_ADMIN_TOKEN" \
-H "Content-Type: application/json" \
-d '{"events": ["alert.created"]}'Respuesta200
{
"id": "whk_4z6x8c2v0b1n",
"url": "https://shop.example.com/hooks/sypnia",
"events": [
"alert.created"
],
"enabled": true,
"created_at": "2026-02-02T09:25:00Z",
"last_delivery": {
"at": "2026-03-12T10:33:06Z",
"status": "delivered",
"response_status": 200
},
"disabled_reason": null
}Errores
- 404
not_foundNingún webhook del proyecto tiene este id.
Borrar un webhook
/v1/webhooks/{webhook_id} MotorNube Borra el webhook y detiene sus entregas pendientes.
Parámetros de ruta
-
webhook_idstring obligatorioEl id del webhook (
whk_…).
Parámetros de consulta
-
projectstring opcionalEl id o el slug del proyecto. Solo hace falta con una credencial que ve varios proyectos (el token raíz). Con un token de API se ignora, salvo que nombre otro proyecto, que es
403.
Petición
curl -X DELETE "https://api.sypnia.com/v1/webhooks/whk_4z6x8c2v0b1n" \
-H "Authorization: Bearer $SYPNIA_ADMIN_TOKEN"Errores
- 404
not_foundNingún webhook del proyecto tiene este id.
Listar las entregas de un webhook
/v1/webhooks/{webhook_id}/deliveries MotorNube Lo que se le envió al webhook y cómo respondió tu receptor, lo más nuevo primero. Las entregas se guardan 30 días. Sirve para saber por qué no llegó una alerta.
Parámetros de ruta
-
webhook_idstring obligatorioEl id del webhook (
whk_…).
Parámetros de consulta
-
projectstring opcionalEl id o el slug del proyecto. Solo hace falta con una credencial que ve varios proyectos (el token raíz). Con un token de API se ignora, salvo que nombre otro proyecto, que es
403. -
statusstring opcionalSolo entregas en este estado. Uno de:
pending,delivered,failed. -
limitinteger, 1 a 200 opcionalMáximo de elementos que se devuelven.
Por defecto:
50 -
cursorstring opcionalEl
next_cursorde la página anterior. Deja iguales todos los demás parámetros.
Petición
curl "https://api.sypnia.com/v1/webhooks/whk_4z6x8c2v0b1n/deliveries?status=failed" \
-H "Authorization: Bearer $SYPNIA_ADMIN_TOKEN"Respuesta200
{
"data": [
{
"id": "dlv_2s4d6f8g0h1j",
"event_id": "evt_7m3n9b5v1c8x",
"event_type": "alert.created",
"status": "delivered",
"attempts": 1,
"response_status": 200,
"response_ms": 142,
"created_at": "2026-03-12T09:13:03Z",
"delivered_at": "2026-03-12T09:13:03Z",
"next_attempt_at": null,
"error": null
}
],
"next_cursor": null
}Errores
- 404
not_foundNingún webhook del proyecto tiene este id.
Enviar un evento de prueba
/v1/webhooks/{webhook_id}/test MotorNube Le envía ahora un evento ping al webhook, firmado como uno real, y responde con lo que dijo tu receptor. No se reintenta y no se guarda como entrega.
Parámetros de ruta
-
webhook_idstring obligatorioEl id del webhook (
whk_…).
Parámetros de consulta
-
projectstring opcionalEl id o el slug del proyecto. Solo hace falta con una credencial que ve varios proyectos (el token raíz). Con un token de API se ignora, salvo que nombre otro proyecto, que es
403.
Petición
curl -X POST "https://api.sypnia.com/v1/webhooks/whk_4z6x8c2v0b1n/test" \
-H "Authorization: Bearer $SYPNIA_ADMIN_TOKEN"Respuesta200
{
"ok": true,
"response_status": 200,
"response_ms": 131,
"error": null
}Errores
- 404
not_foundNingún webhook del proyecto tiene este id.
Los errores que cualquier endpoint puede responder (401, 403, 429, 500, 503) están en Errores, límites, paginación.