Documentación para integradores

Base URL

https://cursoredes.frba.utn.edu.ar/v1

Autenticación

Algunos endpoints requieren un header X-Api-Key con la clave de tu cuenta de partner. Los recursos de cuenta usan autenticación HTTP Basic con las credenciales que te dio tu contacto comercial.

Límites de uso

Algunos endpoints aplican límites de uso por IP o por cuenta. Si se supera el límite, la respuesta incluye un código 429 y un header Retry-After. Los límites varían por endpoint y no están garantizados a futuro.

Formato de respuestas

Las respuestas exitosas son JSON salvo que se indique lo contrario (por ejemplo, descargas de archivos). Algunas respuestas incluyen encabezados de caché estándar.

Estado

• GET/v1/status Estado general del servicio.
• GET/health Alias legado, deprecado. Redirige a /v1/status.

Envíos

• GET/v1/shipments Lista los envíos de tu cuenta.
• POST/v1/shipments/cancel Cancela un envío en curso.
• GET/v1/shipments/canonical URL canónica de un envío cuando existe un duplicado.
• GET/v1/shipments/{id}/label Etiqueta de envío. Ejemplo: /v1/shipments/DEMO-4471/label.
• GET/v1/shipments/{id}/proof Comprobante de entrega. Ejemplo: /v1/shipments/DEMO-4471/proof.

Seguimiento

• GET/v1/tracking/events Eventos de seguimiento de un envío.

Transportistas

• GET/v1/carriers/status Estado reportado por el transportista externo asignado a un envío.

Tarifas

• GET/v1/rates/quote Cotiza una tarifa de envío según origen, destino y peso.

Reportes

• GET/v1/reports/export Genera un reporte de envíos para el período solicitado.
• GET/v1/reports/download Descarga el archivo de reporte generado.

Webhooks

• GET/v1/webhooks/last-payload Último payload recibido en el webhook de prueba configurado para tu cuenta.

Cuenta

• GET/v1/account Datos de tu cuenta de partner. Requiere autenticación.

Meta

• GET/v1/meta/version Versión y build del servicio.

Portal de partners

Además de la API, existe un portal web para partners. El acceso ahí es independiente de la API.