Endpoints

Un endpoint es la URL de tu servidor que recibe los webhooks. Con Webhooks 2.0 puedes tener hasta 10, y cada uno recibe solo los eventos que elijas para él.

Crea un endpoint

Headers de autenticación

El token, el nombre del header y las credenciales los eliges tú; Tonder los guarda y los envía en cada solicitud. Verifica la firma en todos los casos: un header de autenticación es una capa adicional, no un reemplazo.

Genera un valor largo y aleatorio para cada endpoint, y no reutilices tu llave de API de Tonder ni otra credencial. No pongas tokens en la URL del endpoint: la URL se muestra en la lista de endpoints.

Administra los endpoints

Cada endpoint de Desarrolladores › Webhooks tiene un menú de acciones:

La lista muestra, para cada endpoint, el método de autenticación, los eventos suscritos, la tasa de error de las últimas 24 horas y el estado. Todo lo de esta pantalla también está disponible por la API de webhooks.

Solución de problemas

• El endpoint no recibe un evento: revisa que esté Activo, suscrito a ese evento, accesible públicamente por HTTPS y respondiendo un 2xx en menos de 10 segundos. Busca el evento en el registro de eventos para ver qué respondió tu servidor.
• La URL se rechaza al crear el endpoint: no empieza con https:// o apunta a una dirección privada o interna.
• Tu servidor rechaza las solicitudes: revisa que espere el método de autenticación y las credenciales configurados en el endpoint, y que verifique la firma con el secreto vigente.

Cuentas sin Webhooks 2.0

En la versión anterior registras una URL por API, y esa URL recibe todos los eventos.

Registra la URL

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"
  }
}

Métodos de autenticación

Lo que recibe tu endpoint depende del auth_method que configures:

Con API_TOKEN defines tanto el nombre del header como su valor, y lo enviamos tal cual, sin agregar ningún prefijo. Para recibir Authorization: Token abc123, configura header: "Authorization" y token: "Token abc123". Un header propio, como X-Api-Key, también funciona.

{
  "url": "https://your-site.com/webhook-handler",
  "auth_method": "API_TOKEN",
  "credentials": {
    "header": "X-Api-Key",
    "token": "a-secret-you-generate"
  }
}

En todos los casos el secreto lo generas tú. Lo guardamos y lo reenviamos en cada notificación para que tu backend pueda validarlo.

Gestiona la URL

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"

En la versión anterior el endpoint debe responder un 2xx en menos de 30 segundos, y cada evento se entrega una sola vez —ver Sin Webhooks 2.0.

Siguientes pasos