​
DJI 云端命令

DJI 云端命令用于通过开放平台提交 DJI 控制、任务、配置、直播、文件、固件等操作请求。001 当前完成的是平台侧命令受理、命令事实持久化、dispatch event 创建和命令查询；实际设备执行由后续 DJI adapter 服务完成。

​
API 入口

操作方法与路径
创建命令POST /api/v1/open/downlink/commands
查询命令状态GET /api/v1/open/downlink/commands/{commandId}

​
调用流程

  1. 调用创建命令接口，设置 vendor=dji、command_type 与该 method 所需的 payload。
  2. 平台返回 command_id 与受理状态 ACCEPTED。
  3. 001 将命令事实和 dispatch event 持久化，并尝试发布 command.accepted 事件。
  4. 使用 command_id 查询平台已受理命令事实和 dispatch 发布状态。设备执行终态需要后续 adapter / callback / query 能力写入后才会出现。

​
请求字段

字段类型必填说明
vendorstring是固定 dji
device_idstring是目标设备 ID
command_typestring是DJI method 名称
payloadobject是method 对应负载
idempotency_keystring是幂等键，同一业务请求重试时保持不变
timeout_secondsinteger否超时秒数，范围 0~300

​
状态模型

状态说明
ACCEPTED平台已受理命令
DELIVERED后续 adapter 写入：命令已投递到设备侧
SUCCEEDED后续 adapter 写入：设备执行成功
FAILED后续 adapter 写入：设备执行失败
TIMED_OUT后续调度/adapter 写入：超过命令超时时间仍未收到终态
UNMATCHED_RESPONSE后续关联逻辑写入：收到设备回包但未能与命令正确关联

​
示例请求

{
  "vendor": "dji",
  "device_id": "dock-001",
  "command_type": "camera_mode_switch",
  "payload": {
    "payload_index": "52-0-0",
    "camera_mode": 0
  },
  "idempotency_key": "req-20260423-0001",
  "timeout_seconds": 30
}
选择左侧的能力域查看具体 method 的 payload 字段、请求示例和响应示例。
能力域method 数量用途
device21机库 / 设备控制、维护与模式切换
camera17相机与云台拍摄、对焦、曝光、构图
drc12遥控接管与直接飞控
wayline9航线任务生命周期与返航控制
live4直播推流启停、画质与镜头切换
psdk10负载与喊话器交互、自定义数据通道
file4文件 / 媒体上传与传输流程
safety5围栏、解禁、许可证与安全策略
firmware1固件 OTA 任务创建

​
下一步

从左侧选择一个能力域，进入具体 method 页面完成联调。