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

Exportar las entregas de un receptor 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 receptor concreto, en CSV con BOM UTF-8 o en XLSX.

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

UUID del endpoint de webhook.

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

Formato del archivo. csv por defecto; xlsx produce una hoja de cálculo. Cualquier otro valor se sirve como csv.

Predeterminado: csv

p. ej. csv
limitqueryintegeropcional

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 con el historial de entregas del endpoint (hasta 100,000 filas).Sin cuerpo
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
c4d5e6f7a8b9
403forbidden

No tienes permiso para acceder a este recurso.

Envelope
meta.request_id
d5e6f7a8b9c0
429rate_limit_exceeded

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

Envelope
meta.request_id
f7a8b9c0d1e2
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 (emitido sólo en 429).
  • X-RateLimit-Remaining: integer — Solicitudes restantes en la ventana actual — siempre 0 en el momento del 429 (emitido sólo en 429).
  • X-RateLimit-Reset: integer — Unix epoch absoluto (segundos) en que se reinicia la ventana. Emitido sólo en 429, junto con Retry-After. Puede existir sobreescritura por endpoint (p. ej. `rate_limited_login`).