​
takeoff_to_point

DJI Services · drc · takeoff_to_point

​
Request Params

​
vendor
string
必填
固定 dji
​
device_id
string
必填
目标设备 ID
​
command_type
string
必填
固定 takeoff_to_point
​
idempotency_key
string
必填
幂等键；重复请求返回同一命令
​
timeout_seconds
integer
超时秒数，范围 0~300
​
payload.target_latitude
number
必填
Target point latitude (-90 to 90)
​
payload.target_longitude
number
必填
Target point longitude (-180 to 180)
​
payload.target_height
number
必填
Target point height (ellipsoidal height, WGS84)
​
payload.security_takeoff_height
number
必填
Safe takeoff height (relative to dock ALT)
​
payload.rth_mode
integer
必填
【必填】返航模式设置值”0”:“智能高度”,“1”:“设定高度”
​
payload.rth_altitude
integer
必填
Return home altitude (relative to dock ALT)
​
payload.rc_lost_action
integer
必填
RC lost action (0=hover, 1=land, 2=RTH)
​
payload.exit_wayline_when_rc_lost
integer
必填
[Deprecated] Wayline lost action (0=continue, 1=exit)
​
payload.commander_mode_lost_action
integer
必填
【必填】Commander mode lost action (0=continue, 1=exit)
​
payload.commander_flight_mode
integer
必填
【必填】指点飞行模式设置值 “0”:“智能高度飞行”,“1”:“设定高度飞行”
​
payload.commander_flight_height
number
必填
【必填】Commander flight height (relative to dock ALT)
​
payload.flight_id
string
必填
One-key takeoff mission UUID
​
payload.max_speed
integer
Max speed (1-15 m/s, optional)
​
payload.flight_safety_advance_check
integer
必填
飞行安全预检查 “0”:“关闭”,“1”:“开启”

​
Create Response

​
command_id
string(uuid)
平台命令受理标识，全平台唯一 UUID
​
status
string
受理状态：ACCEPTED
​
accepted_at
string(datetime)
命令受理时间（UTC）

​
Query Response

​
command_id
string(uuid)
平台命令受理标识，全平台唯一 UUID
​
status
string
执行状态：ACCEPTED / DELIVERED / SUCCEEDED / FAILED / TIMED_OUT / UNMATCHED_RESPONSE
​
vendor
string
厂商标识，固定为 dji
​
device_id
string
目标设备 ID
​
command_type
string
method 名称
​
response_code
string
设备侧执行码
​
response_message
string
设备侧执行信息
​
vendor_response
object
原始厂商回包（透传）

​
DJI Services Reply Mapping

设备通过 services_reply 返回命令结果，平台使用 tid 关联到 command_id 并更新命令状态。接入方不需要直接处理 MQTT 回包。
Open Platform 字段DJI services_reply 来源
response_code优先使用 data.code；不存在时回退到 data.result
response_messagedata.message / data.msg / data.description
vendor_responseDJI 回包摘要，保留 result、code、message、output 等原始扩展字段
data.result = 0 表示设备侧执行成功；非 0 表示设备侧执行失败，平台会将命令推进为失败终态。 
curl -X POST "/api/v1/open/downlink/commands" \
  -H "Content-Type: application/json" \
  -H "X-Api-Id: YOUR_API_ID" \
  -H "X-Api-Timestamp: YOUR_UNIX_SECONDS" \
  -H "X-Api-Nonce: YOUR_NONCE" \
  -H "X-Api-Signature: YOUR_SIGNATURE" \
  -d '{"vendor":"dji","device_id":"drone-001","command_type":"takeoff_to_point","payload":{"target_latitude":0.0,"target_longitude":0.0,"target_height":0.0,"security_takeoff_height":0.0,"rth_mode":0,"rth_altitude":0,"rc_lost_action":0,"exit_wayline_when_rc_lost":0,"commander_mode_lost_action":0,"commander_flight_mode":0,"commander_flight_height":0.0,"flight_id":"id-001","flight_safety_advance_check":0,"max_speed":0},"idempotency_key":"req-takeoff_to_point-001","timeout_seconds":30}'

curl "/api/v1/open/downlink/commands/48e7be50-7edf-9eca-ec62-189f3fcbcc3b"

{
  "command_id": "48e7be50-7edf-9eca-ec62-189f3fcbcc3b",
  "status": "ACCEPTED",
  "accepted_at": "2026-04-22T12:00:00Z"
}