Configuración y gestión

Registra, prueba y administra tus endpoints de webhook desde la API o el Dashboard.

Esta guía explica cómo gestionar tus endpoints de webhook a través de la API de Tonder: crear, actualizar y administrar endpoints para recibir notificaciones en tiempo real.

Requisitos de seguridad: usa una URL segura (HTTPS), configura un método de autenticación (BEARER, API_TOKEN o BASIC_AUTH) para verificar que las peticiones vienen de Tonder, y valida la estructura y el contenido del evento antes de procesarlo.

Paso 1: crea un endpoint

Registra una nueva URL con el endpoint /webhooks/. Puedes configurar la autenticación para asegurar tu endpoint:

curl -X POST https://stage.tonder.io/api/v1/webhooks/ \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-site.com/webhook-handler",
    "auth_method": "BEARER",
    "credentials": {
      "token": "a-secure-bearer-token-you-generate"
    }
  }'

La respuesta confirma el endpoint creado:

{
  "id": 123,
  "url": "https://your-site.com/webhook-handler",
  "status": "active",
  "auth_method": "BEARER",
  "credentials": {
    "token": "a-secure-bearer-token-you-generate"
  }
}

Campo	Tipo	Descripción
`id`	integer	Identificador único del endpoint.
`url`	string	La URL que registraste.
`status`	string	Estado del webhook (`active`, `inactive`).
`auth_method`	string	Método de autenticación (`BEARER`, `API_TOKEN`, `BASIC_AUTH`).
`credentials`	object	Credenciales de autenticación asociadas.

Guarda el id del webhook para las operaciones de gestión.

Paso 2: gestiona los webhooks

Operación	Método	Endpoint	Propósito
Listar	`GET`	`/webhooks/`	Recupera todos los endpoints configurados.
Actualizar	`PUT`	`/webhooks/{webhook_id}/`	Actualiza la configuración de un endpoint.
Eliminar	`DELETE`	`/webhooks/{webhook_id}/`	Elimina un endpoint (deja de recibir notificaciones).

curl -X GET https://stage.tonder.io/api/v1/webhooks/ \
  -H "Authorization: Token YOUR_API_KEY"

curl -X PUT https://stage.tonder.io/api/v1/webhooks/123/ \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://your-updated-site.com/webhook-handler" }'

curl -X DELETE https://stage.tonder.io/api/v1/webhooks/123/ \
  -H "Authorization: Token YOUR_API_KEY"

Solución de problemas

Errores de autenticación al crear webhooks: verifica que tus credenciales sean correctas y tengan permisos; prueba la autenticación localmente antes de registrar el webhook.
El endpoint no recibe eventos tras configurarlo: verifica que sea accesible públicamente vía HTTPS y que responda con un 2xx en menos de 30 segundos.

Configuración y gestión

Paso 1: crea un endpoint

Paso 2: gestiona los webhooks

Solución de problemas

Siguientes pasos

Buenas prácticas

Entrega y reintentos

En esta página