DJI 接入概览
UTMOS 开放平台支持通过统一 API 接入 DJI 机库与无人机。本节介绍下行命令、上行请求两条主链路的调用方式以及如何选择具体能力。下行（云端 → 设备）
上行（设备 → 云端）
下行调用要点
- 创建命令：
POST /api/v1/open/downlink/commands - 查询结果：
GET /api/v1/open/downlink/commands/{commandId}
调用流程
- 调用创建命令接口，平台返回
command_id（全平台唯一 UUID）。 - 平台异步将命令下发到 DJI 设备。
- 设备执行后，使用同一
command_id的查询接口获取status与vendor_response。
鉴权
- API ID + API Key + 请求签名（见 鉴权与签名）
- scope：
open:command:create（创建命令）、open:command:read（查询命令）、open:device-request:read（查询设备请求）、open:device-request:create（回复设备请求）
请求体
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| vendor | string | 是 | 固定 dji |
| device_id | string | 是 | 目标设备 ID |
| command_type | string | 是 | DJI method 名称 |
| payload | object | 是 | method 对应负载 |
| idempotency_key | string | 是 | 幂等键 |
| timeout_seconds | integer | 否 | 超时秒数（0~300） |
查询响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
| command_id | string(uuid) | 命令受理标识 |
| status | string | ACCEPTED / DELIVERED / SUCCEEDED / FAILED / TIMED_OUT / UNMATCHED_RESPONSE |
| response_code | string | 设备侧响应码 |
| response_message | string | 设备侧响应信息 |
| vendor_response | object | 设备回传原始扩展字段 |
能力域
| 能力域 | method 数量 | 用途 |
|---|---|---|
| device | 21 | 机库 / 设备控制、维护与模式切换 |
| camera | 17 | 相机与云台拍摄、对焦、曝光、构图 |
| drc | 12 | 遥控接管与直接飞控 |
| wayline | 9 | 航线任务生命周期与返航控制 |
| psdk | 10 | 负载与喊话器交互、自定义数据通道 |
| safety | 5 | 围栏、解禁、许可证与安全策略 |
| live | 4 | 直播推流启停、画质与镜头切换 |
| file | 4 | 文件 / 媒体上传与传输流程 |
| firmware | 1 | 固件 OTA 任务创建 |
下一步
- 下行对接：从左侧 DJI Downlink Command Methods 进入对应能力域，按 method 完成对接调试
- 上行请求查询：见 DJI 设备请求
- 上行业务回复：见 DJI 设备请求回复