Сохранённые данные и проекты
Транспорт, шаблоны и проекты, общие с приложением.
Транспортные средства, шаблоны грузов и проекты вашей организации — это те же записи, что показывает приложение CargoDuo. Измените запись здесь — она изменится и там.
| Ресурс | ID | Endpoint |
|---|---|---|
| Транспорт | Пресеты: slug (standard-trailer-13-6m), ваши: veh_… | /v1/vehicles (пресеты только для чтения) |
| Шаблоны | tpl_… | /v1/templates |
| Проекты | prj_…; слоты pv_…, позиции item_… | /v1/projects |
Для чтения нужна область доступа resources:read; для создания, изменения и удаления — resources:write. Эти вызовы бесплатны и учитываются в лимитах запросов, как любые другие.
Использование в задании
{
"vehicles": [
{
"vehicle_id": "veh_118",
"quantity": 2
}
],
"items": [
{
"template_id": "tpl_42",
"quantity": 18
},
{
"template_id": "tpl_43",
"quantity": 40,
"weight": 14
}
]
}Поля, переданные рядом с ID, переопределяют сохранённые значения. id по умолчанию равен сохранённому ID.
Проекты
| Шаг | Вызов |
|---|---|
| 1 | POST /v1/projects с названием, транспортными средствами (vehicle_id, quantity) и позициями |
| 2 | POST /v1/projects/{id}/pack: стоимость и выполнение — как у POST /v1/pack |
| 3 | План сохраняется в проект и открывается в приложении (app_url) |
Если кто-то изменит проект во время выполнения задания, план останется только в задании (предупреждение project_not_saved).
Участники
В каждой записи есть created_by и updated_by. Вызов выполняется от имени участника, создавшего ключ. Фильтруйте списки через ?created_by=me или ID участника (usr_…).