快速开始
本页接口清单为规划草稿,正式接口以开发者控制台发布的版本为准。
完成下面四步,就能在沙箱里拿到第一条真实返回。整个过程不需要联系任何人。
- 在 注册页 创建开发者账号,并完成企业或个人认证。
- 进入开发者控制台,新建一个应用,记录系统分配的
client_id与client_secret。 - 为该应用申请沙箱租户,沙箱内已预置示例主数据与单据。
- 用应用凭证换取访问令牌,带着令牌调用任一只读接口。
第一次调用
以下示例以读取工单列表为例,接口域名与路径为示例写法。
curl -X GET "https://api.droplet.example.com/v1/mes/work-orders?page=1&size=20" \
-H "Authorization: Bearer <access_token>" \
-H "Accept: application/json"
返回结构
所有接口统一返回 code、message、data 三个字段;列表类接口的 data 内含 items 与 total。
{
"code": 0,
"message": "ok",
"data": { "items": [], "total": 0, "page": 1, "size": 20 }
}