Gespeicherte Daten & Projekte
Fahrzeuge, Vorlagen und Projekte, die API und App gemeinsam nutzen.
Die Fahrzeuge, Vorlagen und Projekte Ihrer Organisation sind dieselben Datensätze, die die CargoDuo-App anzeigt. Was Sie hier ändern, ändert sich auch dort.
| Ressource | IDs | Endpoints |
|---|---|---|
| Fahrzeuge | Vordefiniert: Slug (standard-trailer-13-6m), eigene: veh_… | /v1/vehicles (vordefinierte sind schreibgeschützt) |
| Vorlagen | tpl_… | /v1/templates |
| Projekte | prj_…; Slots pv_…, Artikel item_… | /v1/projects |
Lesen erfordert resources:read; Erstellen, Ändern und Löschen erfordern resources:write. Diese Aufrufe sind kostenlos und zählen wie alle anderen zu den Rate Limits.
In einem Job verwenden
{
"vehicles": [
{
"vehicle_id": "veh_118",
"quantity": 2
}
],
"items": [
{
"template_id": "tpl_42",
"quantity": 18
},
{
"template_id": "tpl_43",
"quantity": 40,
"weight": 14
}
]
}Neben einer ID gesendete Felder überschreiben die gespeicherten Werte. id ist standardmäßig die gespeicherte ID.
Projekte
| Schritt | Aufruf |
|---|---|
| 1 | POST /v1/projects mit Namen, Fahrzeugen (vehicle_id, quantity) und Artikeln |
| 2 | POST /v1/projects/{id}/pack: bepreist und ausgeführt wie POST /v1/pack |
| 3 | Der Plan wird im Projekt gespeichert und öffnet sich in der App (app_url) |
Bearbeitet jemand das Projekt, während der Job läuft, bleibt der Plan nur am Job (Warnung project_not_saved).
Mitglieder
Jeder Datensatz enthält created_by und updated_by. Ein Aufruf wird dem Mitglied zugerechnet, das den Schlüssel erstellt hat. Filtern Sie Listen mit ?created_by=me oder einer Mitglieds-ID (usr_…).