开发者文档开始使用
已保存数据与项目
与应用共享的车辆、模板和项目。
您组织的车辆、货物模板和项目,与 CargoDuo 应用中显示的是同一批记录。在这里修改,应用中也会同步变更。
| 资源 | ID | 接口 |
|---|---|---|
| 车辆 | 预设车辆: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。API 调用记在创建该密钥的成员名下。可使用 ?created_by=me 或成员 ID(usr_…)筛选列表。