Documentación para desarrolladoresReferencia de la API
Resumen
URL base, convenciones y todos los endpoints.
https://runner.cargoduo.com/v1JSON sobre HTTPS. Longitudes en cm, pesos en kg, importes en créditos.
Endpoints
Carga
| Endpoint | Página | Permiso |
|---|---|---|
POST /v1/pack | Crear un trabajo de carga | pack:write |
POST /v1/estimate | Estimar un trabajo de carga | pack:write |
Trabajos
| Endpoint | Página | Permiso |
|---|---|---|
GET /v1/jobs | Listar trabajos | jobs:read |
GET /v1/jobs/{id} | Consultar un trabajo | jobs:read |
GET /v1/jobs/{id}/result | Consultar el resultado de un trabajo | jobs:read |
DELETE /v1/jobs/{id} | Cancelar un trabajo | pack:write |
Proyectos
| Endpoint | Página | Permiso |
|---|---|---|
GET /v1/projects | Listar proyectos | resources:read |
POST /v1/projects | Crear un proyecto | resources:write |
GET /v1/projects/{id} | Consultar un proyecto | resources:read |
PATCH /v1/projects/{id} | Actualizar un proyecto | resources:write |
DELETE /v1/projects/{id} | Eliminar un proyecto | resources:write |
POST /v1/projects/{id}/pack | Calcular la carga de un proyecto | pack:write y resources:write |
Vehículos
| Endpoint | Página | Permiso |
|---|---|---|
GET /v1/vehicles | Listar vehículos | resources:read |
GET /v1/vehicles/{id} | Consultar un vehículo | resources:read |
POST /v1/vehicles | Crear un vehículo | resources:write |
PATCH /v1/vehicles/{id} | Actualizar un vehículo | resources:write |
DELETE /v1/vehicles/{id} | Eliminar un vehículo | resources:write |
Plantillas
| Endpoint | Página | Permiso |
|---|---|---|
GET /v1/templates | Listar plantillas | resources:read |
GET /v1/templates/{id} | Consultar una plantilla | resources:read |
POST /v1/templates | Crear una plantilla | resources:write |
PATCH /v1/templates/{id} | Actualizar una plantilla | resources:write |
DELETE /v1/templates/{id} | Eliminar una plantilla | resources:write |
Cuenta
| Endpoint | Página | Permiso |
|---|---|---|
GET /v1/limits | Consultar los límites | account:read |
GET /v1/balance | Consultar el saldo | account:read |
GET /v1/usage | Consultar el uso | account:read |
Cabeceras
| Cabecera | Sentido | Significado |
|---|---|---|
Authorization | Solicitud | Bearer cd_live_… |
Content-Type | Solicitud | application/json en POST |
Idempotency-Key | Solicitud | Reintentos seguros de POST /v1/pack y POST /v1/projects/{id}/pack |
X-Request-Id | Respuesta | ID de la solicitud (req_…), en todas las respuestas |
X-RateLimit-Limit / -Remaining / -Reset | Respuesta | La ventana de frecuencia más restrictiva |
X-Credits-Remaining | Respuesta | Créditos disponibles tras la solicitud |
Retry-After | Respuesta | Segundos que hay que esperar, en 429 |
Idempotent-Replayed | Respuesta | true cuando una clave devolvió un trabajo anterior |
Formatos legibles por máquina
openapi.jsonOpenAPI 3.1, con todos los endpoints y esquemas.llms-full.txtla guía de integración para agentes de programación.