Dokumentacja dla deweloperówPierwsze kroki
Zapisane dane i projekty
Pojazdy, szablony i projekty wspólne z aplikacją.
Pojazdy, szablony ładunku i projekty Twojej organizacji to te same rekordy, które pokazuje aplikacja CargoDuo. Zmiana wprowadzona tutaj jest widoczna również tam.
| Zasób | ID | Endpointy |
|---|---|---|
| Pojazdy | Presety: slug (standard-trailer-13-6m), własne: veh_… | /v1/vehicles (presety są tylko do odczytu) |
| Szablony | tpl_… | /v1/templates |
| Projekty | prj_…; sloty pv_…, pozycje item_… | /v1/projects |
Odczyt wymaga resources:read; tworzenie, zmiana i usuwanie wymagają resources:write. Te wywołania są bezpłatne i wliczają się do limitów zapytań jak wszystkie inne.
Użycie w zadaniu
{
"vehicles": [
{
"vehicle_id": "veh_118",
"quantity": 2
}
],
"items": [
{
"template_id": "tpl_42",
"quantity": 18
},
{
"template_id": "tpl_43",
"quantity": 40,
"weight": 14
}
]
}Pola wysłane obok ID nadpisują zapisane wartości. id domyślnie przyjmuje zapisane ID.
Projekty
| Krok | Wywołanie |
|---|---|
| 1 | POST /v1/projects z nazwą, pojazdami (vehicle_id, quantity) i pozycjami |
| 2 | POST /v1/projects/{id}/pack: wyceniane i uruchamiane jak POST /v1/pack |
| 3 | Plan zostaje zapisany w projekcie i otwiera się w aplikacji (app_url) |
Jeśli ktoś edytuje projekt w trakcie zadania, plan zostaje tylko przy zadaniu (ostrzeżenie project_not_saved).
Członkowie organizacji
Każdy rekord ma created_by i updated_by. Wywołanie jest przypisywane członkowi, który utworzył klucz. Filtruj listy przez ?created_by=me lub ID członka (usr_…).
Powiązane
Lista pojazdówWszystkie pojazdy, które możesz wskazać przez vehicle_id: presety (kontenery, naczepy, ciężarówki i palety w typach dostępnych dla Twojej organizacji), a potem własne pojazdy Twojej organizacji.Lista szablonówSzablony ładunku Twojej organizacji (zapisane pozycje), od najnowszych.Zaplanuj załadunek projektuPlanuje załadunek pojazdów i pozycji projektu dokładnie tak jak POST /v1/pack: ta sama cena, rezerwacja kredytów, limity, Idempotency-Key, ?wait= i zadanie.