Saltar al contenido
AchaduDevelopers
Developers/API/webhook_events
Ganchos web

Listar eventos de webhook

Devuelve el catálogo versionado de eventos y descripciones.

GET/webhook-eventswebhooks:read
COMPORTAMIENTO

La lectura respeta los filtros y devuelve solo los recursos visibles para la cuenta vinculada a la clave.

EFECTO

No cambia los recursos ni activa la publicación.

REPETICIÓN

Es seguro repetir la operación. En 429 o 5xx, use retroceso exponencial con fluctuación.

Solicitar

Esta operación no toma parámetros.

AuthorizationBearer ach_live_...
Acceptapplication/json
Alcancewebhooks:read

Ejemplo ejecutable

curl
curl 'https://achadu.com/api/v1/webhook-events' \
  -H 'Authorization: Bearer ach_live_...' \
  -H 'Accept: application/json'

Respuesta y errores

Cada respuesta incluye request_id. Las listas añaden paginación; Los recursos mutables devuelven el estado persistente después de la operación.

200 application/json
{
  "data": [
    {
      "event": "offer.created",
      "version": "2026-08-31",
      "category": "offer",
      "description": "A pending offer was created."
    }
  ],
  "request_id": "req_01J..."
}
200Operación completada.
400Parámetro, cuerpo o transición no válidos.
401Clave faltante, inválida, caducada o revocada.
402El plan de cuenta no libera esta interfaz.
403A chave precisa do escopo webhooks:read.
404La característica no existe en esta cuenta.
409El estado actual impide esta operación.
413El cuerpo JSON supera los 128 KB.
429Se ha superado la ventana de 120 solicitudes por minuto.