​
DJI Services · drc

​
001 能力边界

001 当前只支持通过统一 HTTP command API 受理 DJI DRC /services 类 method。平台会写入 command fact、创建 dispatch event，并返回 command_id。实际低延迟 DRC WebSocket、摇杆控制、急停心跳通道和设备侧执行由后续 realtime / DJI adapter 能力实现。 当前页面只描述已纳入 001 command catalog 的 DRC method 如何通过 HTTP 入口提交。

​
API 入口

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

​
鉴权与 Scope

  • API ID + HMAC 请求签名
  • 创建命令：open:command:create
  • 查询命令：open:command:read

​
调用流程

  1. 调用创建命令接口，设置 vendor=dji、command_type 和该 method 的 payload。
  2. 平台返回 command_id 与 ACCEPTED。
  3. 平台持久化 command fact 和 dispatch event，并尝试发布 command.accepted。
  4. 使用 command_id 查询平台已受理命令事实和 dispatch 发布状态。

​
状态口径

状态说明
ACCEPTED001 已受理并持久化命令
DELIVERED后续 adapter 写入：命令已投递到设备侧
SUCCEEDED后续 adapter 写入：设备执行成功
FAILED后续 adapter 写入：设备执行失败
TIMED_OUT后续调度/adapter 写入：命令超时
UNMATCHED_RESPONSE后续关联逻辑写入：设备回包未能关联到命令

​
全部 method

​
Response

  • Create Response：平台受理态，status=ACCEPTED
  • Query Response：平台命令事实与 dispatch 发布状态；设备执行终态需要后续 adapter 写入