Saltar al contenido
Menú
Saltar la navegación de la documentación

Español API 2026-10-22

Documentación · Referencia · API v1 · versión 2026-10-22

Eventos

Las operaciones de Eventos de la API de Trevol: parámetros, cuerpo, respuestas y ejemplos de código.

Ver como Markdown

Los eventos que Trevol manda a tus webhooks, guardados 30 días, y su reenvío.

Los ejemplos son peticiones con cURL. La llave va en TREVOL_API_KEY; los cuerpos de ejemplo son los de la especificación. Los errores comunes están en Errores.

Reenviar un evento a un endpoint (entrega manual nueva; el webhook-id es el mismo)

POST /v1/events/{id}/resend · resendEvent

Vuelve a mandar el evento a un endpoint activo de la misma empresa y el mismo ambiente. Lleva el mismo webhook-id: si tu servidor ya lo procesó, deduplica con él. Hasta 60 por hora.

Cuerpo (objeto, obligatorio)

  • endpoint_idtextoobligatorio

Respuestas

Estado Qué pasó
202 La entrega encolada (WebhookDelivery)
409 Error (application/problem+json) (Problem)
429 Error (application/problem+json) (Problem)
Error Error (application/problem+json) (Problem)

POST /v1/events/{id}/resend

cURL
curl -X POST "https://api.trevol.si/v1/events/evt_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/resend" \
  -H "Authorization: Bearer $TREVOL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "endpoint_id": "we_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b"
}'

Probar en el Playground

Los eventos de 30 días de la empresa y el ambiente

GET /v1/events · listEvents

Solo se guardan eventos si la empresa tiene al menos un endpoint en este ambiente. Útil para recuperar lo que se perdió mientras tu servidor estaba caído.

Parámetros

  • limitconsultaentero
  • starting_afterconsultatexto
  • typeconsultatexto
  • created_fromconsultatexto
  • created_toconsultatexto

Respuestas

Estado Qué pasó
200 {object: list, data, has_more, next_cursor} (objeto)
Error Error (application/problem+json) (Problem)

GET /v1/events

cURL
curl "https://api.trevol.si/v1/events?limit=100" \
  -H "Authorization: Bearer $TREVOL_API_KEY"

Probar en el Playground

Un evento

GET /v1/events/{id} · retrieveEvent

El evento tal como se mandó al endpoint.

Respuestas

Estado Qué pasó
200 El recurso (Event)
Error Error (application/problem+json) (Problem)

GET /v1/events/{id}

cURL
curl "https://api.trevol.si/v1/events/evt_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b" \
  -H "Authorization: Bearer $TREVOL_API_KEY"

Probar en el Playground