跳到主要内容
开发者文档开始使用

已保存数据与项目

与应用共享的车辆、模板和项目。

您组织的车辆、货物模板和项目,与 CargoDuo 应用中显示的是同一批记录。在这里修改,应用中也会同步变更。

资源ID接口
车辆预设车辆:slug(standard-trailer-13-6m),您自己的车辆:veh_…/v1/vehicles(预设车辆为只读)
模板tpl_…/v1/templates
项目prj_…;车辆条目 pv_…,物品 item_…/v1/projects

读取需要 resources:read;创建、修改和删除需要 resources:write。这些调用不收费,但与其他调用一样计入速率限制。

在任务中使用

JSON
{
  "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。

项目

步骤调用
1POST /v1/projects,提供名称、车辆(vehicle_id、quantity)和物品
2POST /v1/projects/{id}/pack:计价和运行方式与 POST /v1/pack 相同
3方案保存到项目中,并可在应用中打开(app_url)

如果任务运行期间有人修改了项目,方案只保留在任务上(警告 project_not_saved)。

成员

每条记录都包含 created_by 和 updated_by。API 调用记在创建该密钥的成员名下。可使用 ?created_by=me 或成员 ID(usr_…)筛选列表。

相关内容