向设备发送消息

POST

/v2/msg/server/device/{device_id}

在设备唤醒的情况下，可通过服务器下发指令，具体的操作可见文档：https://tange-ai.feishu.cn/docx/TUGQd8xCAoGQ9ixGFuCcpZ3wn9J

请求参数

Path 参数

Header 参数

Body 参数application/json

示例

{
    "callback_id": "myCallbackId",
    "id": "myMsgId",
    "payload": "{\"dt\":\"AJAAAAAAAAA=\",\"rt\":\"tg/callback/myCallbackId\",\"callback_id\":\"myCallbackId\",\"id\":\"myMsgId\"}",
    "topic": "p2pcmd/base64"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v2/msg/server/device/1702D8OBYWWQ' \
--header 'X-Tg-App-Id: xxx' \
--header 'X-Tg-Date: {{currentUTCTime}}' \
--header 'X-Tg-Algorithm: TGV1-HMAC-SHA256' \
--header 'X-Tg-Signed-Headers: x-tg-app-id;x-tg-date' \
--header 'X-Tg-Content-Sha256;' \
--header 'Accept-Language: zh-CN' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "callback_id": "myCallbackId",
    "id": "myMsgId",
    "payload": "{\"dt\":\"AJAAAAAAAAA=\",\"rt\":\"tg/callback/myCallbackId\",\"callback_id\":\"myCallbackId\",\"id\":\"myMsgId\"}",
    "topic": "p2pcmd/base64"
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 200,
    "data": null,
    "msg": "ok",
    "ok": 1,
    "requestid": "f4896661-ac7b-444d-b15f-0753219f8100",
    "status": "ok"
}

🟠400错误

🟠401请登录

🟠403禁止访问

🟠404资源不存在

🔴500服务器内部错误

修改于 2026-01-15 04:27:01