向设备发送消息

开发中

POST

/v2/msg/device/send-by-server/{device_id}

在设备唤醒的情况下，可通过服务器下发指令：
1、directive：p2pcmd/base64
2、data：数据可以是二进制或文本，但都需要经过base64编码
data可能的数据是将以下字符串
{"k1":"v2"}
转码成base64字符串

请求参数

Path 参数

device_id

string

设备ID

必需

示例值:

1702D8OBYWWQ

Header 参数

X-Tg-App-Id

string

必需

开发者帐号的APPID

默认值:

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

Authorization

string

必需

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

默认值:

X-Tg-Signed-Headers

string

必需

参与计算签名的header字段。POST等请求传入content-length;content-type;x-tg-app-id;x-tg-date，GET请求传入x-tg-app-id;x-tg-date

默认值:

x-tg-app-id;x-tg-date

示例值:

content-length;content-type;x-tg-app-id;x-tg-date

X-Tg-Date

string

必需

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

默认值:

20060102T150405Z

Body 参数application/json

string

消息ID

可选

响应消息时，原样返回

callback_id

string

消息回调ID

可选

平台将设备响应的消息，投递到开发者订阅的API接口

topic

string

消息主题

必需

data

string

消息内容

必需

示例

{
    "id": "string",
    "callback_id": "string",
    "topic": "string",
    "data": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v2/msg/device/send-by-server/1702D8OBYWWQ' \
--header 'X-Tg-App-Id;' \
--header 'Accept-Language;' \
--header 'Authorization;' \
--header 'X-Tg-Signed-Headers;' \
--header 'X-Tg-Date;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": "string",
    "callback_id": "string",
    "topic": "string",
    "data": "string"
}'

返回响应

🟢200成功

application/json

Body

code

integer

状态码

必需

200成功

msg

string

状态描述

必需

示例

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

🟠400错误

🟠401请登录

🟠403禁止访问

🟠404资源不存在

🔴500服务器内部错误

修改于 2025-05-07 02:09:11

向设备发送预定义指令

向APP发送消息