GET
/
api
/
v1
/
open
/
downlink
/
commands
/
{command_id}
查询云端到设备命令
curl --request GET \
  --url https://api.example.com/api/v1/open/downlink/commands/{command_id} \
  --header 'X-Api-Id: <x-api-id>' \
  --header 'X-Api-Nonce: <x-api-nonce>' \
  --header 'X-Api-Signature: <api-key>' \
  --header 'X-Api-Timestamp: <x-api-timestamp>'
{
  "command_id": "100e2826-e45b-50cb-b41f-e8df6d20bea2",
  "status": "ACCEPTED",
  "vendor": "dji",
  "device_id": "drone-001",
  "command_type": "camera_photo_take",
  "timeout_seconds": 30,
  "accepted_at": "2026-04-22T12:00:00Z",
  "dispatch_status": "PENDING",
  "publish_attempts": 0,
  "published_at": null,
  "last_error": null,
  "request_id": "req-001"
}

授权

​
X-Api-Signature
string
header
必填

HMAC signature; X-Api-Id, X-Api-Timestamp, and X-Api-Nonce are also required.

请求头

​
X-Api-Id
string
必填

API credential ID.

​
X-Api-Timestamp
string
必填

Unix timestamp in seconds.

​
X-Api-Nonce
string
必填

Replay-protection nonce.

​
X-Api-Signature
string
必填

HMAC request signature.

​
X-Request-Id
string

Optional correlation ID.

路径参数

​
command_id
string
必填

Command ID

响应

Command fact and dispatch state.

​
command_id
string<uuid>
必填
​
status
enum<string>
必填
可用选项:
ACCEPTED,
DISPATCHING,
DELIVERED,
RUNNING,
SUCCEEDED,
FAILED,
TIMED_OUT,
UNSUPPORTED,
CANCELLED,
UNKNOWN
​
vendor
string
必填
示例:

"px4"

​
device_id
string
必填
​
command_type
string
必填
​
timeout_seconds
integer
必填
​
accepted_at
string<date-time>
必填
​
dispatch_status
enum<string>
必填
可用选项:
PENDING,
PUBLISHED,
FAILED,
DEAD
​
publish_attempts
integer
必填
​
request_id
string
必填
​
public_status
enum<string>
必填
可用选项:
ACCEPTED,
DISPATCHING,
DELIVERED,
RUNNING,
SUCCEEDED,
FAILED,
TIMED_OUT,
UNSUPPORTED,
CANCELLED,
UNKNOWN
​
published_at
string<date-time> | null
​
last_error
string | null
​
adapter_result
object

adapter 或设备返回的终态结果。command accepted 不代表设备执行成功，调用方应以该结果或回调为准。