向设备发送预定义指令

将废弃

POST

/v2/msg/directive/device/{device_id}

指令模块

向设备发送指令
1、重启设备：directive=reboot
2、抓取截屏：directive=save_video，默认分辨率640*480，抓高清图时data字段传JSON对象：{"res":"high"}

请求参数

Path 参数

device_id

string

必需

Header 参数

X-Tg-App-Id

string

必需

开发者帐号的APPID

默认值:

X-Tg-Platform

string

必需

请求来源：android/ios/pc/web/device

默认值:

示例值:

androidiOSwebdevicepc

X-Tg-Sdk-Version

string

必需

API SDK版本号：1024

默认值:

Accept-Language

string

必需

请求端的本地语言（zh-cn, zh-tw, en-us, ja, ko, vi, es, pt, ru, tr, de, it, fr, pl, th, ar）

默认值:

示例值:

zh-cnzh-twen-usjakoviesptrutrdeitfrplthar

X-Tg-App-Store

string

手机APP应用商店

可选

默认值:

X-Tg-App-Pkgname

string

手机APP包名

必需

默认值:

Authorization

string

必需

服务端接口时传入签名计算后的字符串。客户端APP传入用户登陆态数据access_token。两者不要混用。

默认值:

X-Tg-Date

string

必需

当前请求的UTC+0时间（注意时区，不是本地时区）

默认值:

20060102T150405Z

X-Tg-App-Version

string

APP版本号

可选

默认值:

Body 参数application/json

directive

string

指令名称

必需

重启=reboot, 截屏=save_video

示例值:

reboot

data

object

指令参数，支持字典、数组

可选

指令需要传数据的情况下用到

reactive

boolean

是否返回指令的响应

必需

响应式的指令才需要传true

示例

{
    "directive": "reboot",
    "reactive": false,
    "data": ""
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v2/msg/directive/device/' \
--header 'X-Tg-App-Id;' \
--header 'X-Tg-Platform;' \
--header 'X-Tg-Sdk-Version;' \
--header 'Accept-Language;' \
--header 'X-Tg-App-Store: {{appstore}}' \
--header 'X-Tg-App-Pkgname;' \
--header 'Authorization;' \
--header 'X-Tg-Date;' \
--header 'X-Tg-App-Version: {{app_version}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "directive": "reboot",
    "reactive": false,
    "data": ""
}'

返回响应

🟢200成功

application/json

Body

code

integer

错误码

必需

200表示成功

msg

string

错误描述

必需

data

object

数据

必需

成功时返回的数据

示例

{
    "code": 0,
    "msg": "string",
    "data": {}
}

🟠400错误

🟠401请登录

🟠403禁止访问

🟠404资源不存在

🔴500服务器内部错误

修改于 2025-05-23 08:42:16

查询云事件摘要

获取验证码