dji-cloud-api
  1. 机场（Dock）控制器类。
dji-cloud-api
  • WaylineJobController
    • Create a wayline task for the Dock.
      POST
    • Paginate through all jobs in this workspace.
      GET
    • Send the command to cancel the jobs.
      DELETE
    • Set the media files for this job to upload immediately.
      POST
    • updateJobStatus
      PUT
  • WaylineFileController
    • get wayline list
      GET
    • get wayline file download address
      GET
    • get wayline file download address
      GET
    • get duplicated wayline name
      GET
    • file upload result report
      POST
    • batch favorites wayline
      POST
    • batch unfavorites wayline
      DELETE
    • Delete the wayline file in the workspace according to the wayline id.
      DELETE
    • Import kmz wayline files.
      POST
  • StorageController
    • Get STS Token
      POST
  • DRC（直接遥控）控制器类。
    • 建立DRC连接。
    • 进入DRC模式。
    • 退出DRC模式。
  • 机场（Dock）控制器类。
    • 创建远程调试任务。
      POST
    • 飞向指定点位。
      POST
    • 停止飞向点位任务。
      DELETE
    • 从指定点位起飞。
      POST
    • 夺取飞行控制权限。
      POST
    • 夺取负载设备控制权限。
      POST
    • 发送负载设备命令。
      POST
    • 关闭舱盖
      PUT
    • coverForceClose
      PUT
    • coverOpen
      PUT
    • debugModeOpen
      PUT
  • UserController
    • Query the information of the current user.
    • Paging to query all users in a workspace.
    • Modify user information. Only mqtt account information is included, nothing else can be modified.
  • LoginController
    • login
    • refreshToken
  • DeviceController
    • 在一个工作区中获取所有在线设备的拓扑列表。
    • 将设备绑定到工作空间后，设备数据只能在 Web 上看到。
    • 根据设备 sn 获取设备信息。
    • 在一个工作区中获取绑定设备列表。
    • 移除设备的绑定状态。
    • 更新设备信息。
    • 提供离线固件升级任务。
    • 设置无人机的属性参数。
    • 获取当前工作空间下设备类型数量。
    • 获取所有工作空间下设备类型数量。
    • 查询每个 domain 下设备总数与在线数
  • TopologyController
    • obtain device topology list
  • DeviceHmsController
    • Page to query the hms information of the device.
    • Update unread hms messages to read status.
    • Get hms messages for a single device.
  • WorkspaceController
    • Gets information about the workspace that the current user is in.
  • DeviceLogsController
    • Obtain the device upload log list by paging according to the query parameters.
    • Get a list of log files that can be uploaded in real time.
    • Initiate a log upload request to the gateway.
    • Cancel logs file upload.
    • Delete upload history.
    • Query the download address of the file according to the wayline file id,
  • LiveStreamController
    • 获取当前直播流容量信息。
    • 获取当前直播流容量信息。
    • 查询全部能进行直播的设备
    • 根据设备sn查询设备直播信息
    • 根据设备sn查询设备直播信息
    • Live streaming according to the parameters passed in from the web side.
    • Stop live streaming according to the parameters passed in from the web side.
    • Set the quality of the live streaming according to the parameters passed in from the web side.
    • liveLensChange
  • DeviceFirmwareController
    • Get the latest firmware version information for this device model.
    • Query firmware information based on parameters.
    • Import firmware file for device upgrades.
    • Change the firmware availability status.
  • FileController
    • Get information about all the media files in this workspace based on the workspace id.
    • Query the download address of the file according to the media file id,
  • MediaController
    • media fast upload
    • app reports file upload result
    • checks whether the file fingerprint exists
    • callback after the file group upload complete
  • DeviceDataController
    • getDeviceFlightAreaStatus
  • FlightAreaController
    • getFlightAreas
    • createFlightArea
    • deleteFlightArea
    • updateFlightArea
    • syncFlightArea
  • WorkspaceElementController
    • get map elements
    • create map element
    • update map element
    • delete map element
    • Delete all the element information in this group based on the group id.
  • 航线生成控制器
    • 生成航线
    • KMZ文件转JSON
    • 云端KMZ文件转JSON
  • WeatherController
    • 根据区域编码获取天气信息
    • 通过经纬度查询天气
  1. 机场（Dock）控制器类。

从指定点位起飞。

POST
/${url.control.prefix}${url.control.version}/devices/{sn}/jobs/takeoff-to-point
控制无人机从当前位置起飞并飞向指定点位。

请求参数

Path 参数
sn
string 
必需
设备序列号，用于唯一标识设备
Header 参数
x-auth-token
string 
可选
默认值:
eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ3b3Jrc3BhY2VfaWQiOiJlM2RlYTBmNS0zN2YyLTRkNzktYWU1OC00OTBhZjMyMjgwNjkiLCJzdWIiOiJDbG91ZEFwaVNhbXBsZSIsInVzZXJfdHlwZSI6IjEiLCJuYmYiOjE3NDkwODYzMDEsImxvZyI6IkxvZ2dlcltjb20uZGppLnNhbXBsZS5jb21tb24ubW9kZWwuQ3VzdG9tQ2xhaW1dIiwiaXNzIjoiREpJIiwiaWQiOiJhMTU1OWU3Yy04ZGQ4LTQ3ODAtYjk1Mi0xMDBjYzQ3OTdkYTIiLCJleHAiOjE4MzU0ODYzMDEsImlhdCI6MTc0OTA4NjMwMSwidXNlcm5hbWUiOiJhZG1pblBDIn0.W5x4fh7PWALqknARx8aoGQhK8ci5t6U7mITN1Gbn4H0
Body 参数application/json
起飞点位参数，包含目标经纬度、高度等信息
flightId
string 
可选
targetLongitude
number 
必需
>= -180<= 180
targetLatitude
number 
必需
>= -90<= 90
targetHeight
number 
必需
>= 2<= 10000
securityTakeoffHeight
number 
必需
>= 2<= 1500
rthAltitude
number 
必需
>= 2<= 1500
rcLostAction
enum<string> 
必需
枚举值:
HOVERLANDRETURN_HOME
exitWaylineWhenRcLost
enum<string> 
必需
枚举值:
CONTINUEEXECUTE_RC_LOST_ACTION
maxSpeed
number 
必需
>= 1<= 15
rthMode
enum<string> 
可选
枚举值:
OPTIMAL_HEIGHTPRESET_HEIGHT
commanderModeLostAction
enum<string> 
可选
枚举值:
CONTINUEEXECUTE_RC_LOST_ACTION
commanderFlightMode
enum<string> 
可选
枚举值:
SMART_HEIGHTSETTING_HEIGHT
commanderFlightHeight
number 
可选
>= 2<= 3000
示例
{
    "flightId": "string",
    "targetLongitude": -180,
    "targetLatitude": -90,
    "targetHeight": 2,
    "securityTakeoffHeight": 2,
    "rthAltitude": 2,
    "rcLostAction": "HOVER",
    "exitWaylineWhenRcLost": "CONTINUE",
    "maxSpeed": 1,
    "rthMode": "OPTIMAL_HEIGHT",
    "commanderModeLostAction": "CONTINUE",
    "commanderFlightMode": "SMART_HEIGHT",
    "commanderFlightHeight": 2
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/$$/devices//jobs/takeoff-to-point' \
--header 'x-auth-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ3b3Jrc3BhY2VfaWQiOiJlM2RlYTBmNS0zN2YyLTRkNzktYWU1OC00OTBhZjMyMjgwNjkiLCJzdWIiOiJDbG91ZEFwaVNhbXBsZSIsInVzZXJfdHlwZSI6IjEiLCJuYmYiOjE3NDkwODYzMDEsImxvZyI6IkxvZ2dlcltjb20uZGppLnNhbXBsZS5jb21tb24ubW9kZWwuQ3VzdG9tQ2xhaW1dIiwiaXNzIjoiREpJIiwiaWQiOiJhMTU1OWU3Yy04ZGQ4LTQ3ODAtYjk1Mi0xMDBjYzQ3OTdkYTIiLCJleHAiOjE4MzU0ODYzMDEsImlhdCI6MTc0OTA4NjMwMSwidXNlcm5hbWUiOiJhZG1pblBDIn0.W5x4fh7PWALqknARx8aoGQhK8ci5t6U7mITN1Gbn4H0' \
--header 'Content-Type: application/json' \
--data-raw '{
    "flightId": "string",
    "targetLongitude": -180,
    "targetLatitude": -90,
    "targetHeight": 2,
    "securityTakeoffHeight": 2,
    "rthAltitude": 2,
    "rcLostAction": "HOVER",
    "exitWaylineWhenRcLost": "CONTINUE",
    "maxSpeed": 1,
    "rthMode": "OPTIMAL_HEIGHT",
    "commanderModeLostAction": "CONTINUE",
    "commanderFlightMode": "SMART_HEIGHT",
    "commanderFlightHeight": 2
}'

返回响应

🟢200成功
application/json
Body
HttpResultResponse 操作结果响应
code
integer 
可选
0 means success, non-zero means error.
示例值:
0
message
string 
可选
The response message.
示例值:
success
data
object (Object) 
可选
The response data.
示例
{
  "code": 0,
  "message": "",
  "data": {}
}
修改于 2025-06-05 01:52:34
上一页
停止飞向点位任务。
下一页
夺取飞行控制权限。
Built with