EntwicklerdokumentationAPI-Referenz
Übersicht
Basis-URL, Konventionen und alle Endpoints.
https://runner.cargoduo.com/v1JSON über HTTPS. Längen in cm, Gewichte in kg, Beträge in Credits.
Endpoints
Ladeplanung
| Endpoint | Seite | Berechtigung |
|---|---|---|
POST /v1/pack | Job erstellen | pack:write |
POST /v1/estimate | Job-Kosten schätzen | pack:write |
Jobs
| Endpoint | Seite | Berechtigung |
|---|---|---|
GET /v1/jobs | Jobs auflisten | jobs:read |
GET /v1/jobs/{id} | Job abrufen | jobs:read |
GET /v1/jobs/{id}/result | Job-Ergebnis abrufen | jobs:read |
DELETE /v1/jobs/{id} | Job abbrechen | pack:write |
Projekte
| Endpoint | Seite | Berechtigung |
|---|---|---|
GET /v1/projects | Projekte auflisten | resources:read |
POST /v1/projects | Projekt erstellen | resources:write |
GET /v1/projects/{id} | Projekt abrufen | resources:read |
PATCH /v1/projects/{id} | Projekt aktualisieren | resources:write |
DELETE /v1/projects/{id} | Projekt löschen | resources:write |
POST /v1/projects/{id}/pack | Projekt berechnen | pack:write und resources:write |
Fahrzeuge
| Endpoint | Seite | Berechtigung |
|---|---|---|
GET /v1/vehicles | Fahrzeuge auflisten | resources:read |
GET /v1/vehicles/{id} | Fahrzeug abrufen | resources:read |
POST /v1/vehicles | Fahrzeug erstellen | resources:write |
PATCH /v1/vehicles/{id} | Fahrzeug aktualisieren | resources:write |
DELETE /v1/vehicles/{id} | Fahrzeug löschen | resources:write |
Vorlagen
| Endpoint | Seite | Berechtigung |
|---|---|---|
GET /v1/templates | Vorlagen auflisten | resources:read |
GET /v1/templates/{id} | Vorlage abrufen | resources:read |
POST /v1/templates | Vorlage erstellen | resources:write |
PATCH /v1/templates/{id} | Vorlage aktualisieren | resources:write |
DELETE /v1/templates/{id} | Vorlage löschen | resources:write |
Konto
| Endpoint | Seite | Berechtigung |
|---|---|---|
GET /v1/limits | Limits abrufen | account:read |
GET /v1/balance | Guthaben abrufen | account:read |
GET /v1/usage | Nutzung abrufen | account:read |
Header
| Header | Richtung | Bedeutung |
|---|---|---|
Authorization | Anfrage | Bearer cd_live_… |
Content-Type | Anfrage | application/json bei POST |
Idempotency-Key | Anfrage | Sichere Wiederholungen von POST /v1/pack und POST /v1/projects/{id}/pack |
X-Request-Id | Antwort | Anfrage-ID (req_…), bei jeder Antwort |
X-RateLimit-Limit / -Remaining / -Reset | Antwort | Das strengste Rate-Limit-Fenster |
X-Credits-Remaining | Antwort | Verfügbare Credits nach der Anfrage |
Retry-After | Antwort | Wartezeit in Sekunden, bei 429 |
Idempotent-Replayed | Antwort | true, wenn ein Schlüssel einen früheren Job wiederholt hat |
Maschinenlesbar
openapi.jsonOpenAPI 3.1, alle Endpoints und Schemas.llms-full.txtdas Integrations-Playbook für Coding-Agenten.