GEThttps://api.veriko.mx/v1/webhooks/{id}/deliveries/export

Exportar las entregas de un endpoint webhook como CSV o XLSX

Audiencia
public
Autenticación
API key
Permiso
webhooks:read
Guía de uso →

Descarga hasta 100 000 registros del historial de entregas de un endpoint específico, en formato CSV o XLSX.

Parámetros
ParámetroUbicaciónTipoObligatorioDescripción
id*pathstring (uuid)obligatorio

Identificador único del endpoint webhook (UUID v4).

p. ej. f47ac10b-58cc-4372-a567-0e02b2c3d479
formatquerystringopcional

Formato del archivo a descargar. Valores aceptados: csv y xlsx. Cualquier otro valor se sirve como csv.

Predeterminado: csv

p. ej. csv
limitqueryintegeropcional

Filtro — Recorta el número de filas del archivo. Solo baja el tope: un valor mayor que 100 000, o menor que 1, deja el tope por defecto.

p. ej. 500
Petición
curl -X GET 'https://api.veriko.mx/v1/webhooks/{id}/deliveries/export' \
  -H 'Authorization: Bearer veriko_••••'

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

Códigos de respuestaGET /v1/webhooks/{id}/deliveries/export
CódigoClaseDescripciónCuerpo
2002xxArchivo CSV o XLSX con el historial de entregas del endpoint (hasta 100 000 filas).Cuerpo sin schema
4014xxSe requiere autenticación o las credenciales son inválidasErrorResponse
4034xxPermisos insuficientesErrorResponse
4044xxEl recurso no existe o no es visible para el clienteError
4294xxLímite de tasa excedidoErrorResponse
Errores de GET /v1/webhooks/{id}/deliveries/export
CódigoClaveEjemplo
401unauthorized

Credenciales de autenticación ausentes o inválidas.

Envelope
meta.request_id
c4d5e6f7a8b99b8a7f6e5d4c
403permission_denied

No tienes permiso para acceder a este recurso.

Envelope
meta.request_id
d5e6f7a8b9c00c9b8a7f6e5d
429rate_limit_exceeded

Límite de peticiones excedido. Inténtalo de nuevo en 45 segundos.

Envelope
meta.request_id
f7a8b9c0d1e22e1d0c9b8a7f
Cabeceras de respuesta
  • Retry-After: integer — Segundos a esperar antes de reintentar. Coincide con la ventana de rate-limit del endpoint (típicamente 60s para listas, 1-5s para operaciones idempotentes en vuelo).
  • X-RateLimit-Limit: integer — Límite de solicitudes configurado para este bucket. Se emite en cada 429 y, en la API autenticada, también en las respuestas correctas, donde es el tope por clave del plan de la cuenta.
  • X-RateLimit-Remaining: integer — Solicitudes restantes en la ventana actual. Siempre 0 en el momento del 429; en una respuesta correcta de la API autenticada es lo que queda del tope por clave.
  • X-RateLimit-Reset: integer — Unix epoch absoluto (segundos) en que se reinicia la ventana. Se emite en cada 429, junto con Retry-After, y en las respuestas correctas de la API autenticada. Puede existir sobreescritura por endpoint (p. ej. `rate_limited_login`).