签发设备令牌

测试中

POST

/v2/device/token/{device_id}

用户调用此接口对指定设备签发令牌，令牌有效期内，可以调用设备令牌专用接口对设备进行操作，相当于获取了设备的权限。

请求参数

Path 参数

Header 参数

Body 参数application/json

示例

{
    "expires_in": 600,
    "scene": ["device/connection","device/telnet"]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v2/device/token/1702D8OBYWWQ' \
--header 'X-Tg-App-Id: xxx' \
--header 'X-Tg-Platform: {{platform}}' \
--header 'X-Tg-Sdk-Version: 23910000' \
--header 'X-Tg-App-Store: {{appstore}}' \
--header 'X-Tg-App-Version: {{app_version}}' \
--header 'X-Tg-App-Pkgname: {{pkgname}}' \
--header 'X-Tg-Date: {{currentUTCTime}}' \
--header 'Accept-Language: zh-CN' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "expires_in": 600,
    "scene": ["device/connection","device/telnet"]
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 200,
    "msg": "ok",
    "data": {
        "access_token": "eyJhbGciOiJFZERTQSIsImtpZCI6Im8xWnkzWE5TSGhxOCIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIzNCIsImlzcyI6ImFwcC9sb2dpbiIsImlhdCI6MTc1MDMwMDk3MywiZXhwIjoxNzUwOTA1NzczLCJhdWQiOlsiYXBwL2JhY2tlbmQiXSwidWlkIjozNCwiYXBwX2lkIjoiMTU1MzE1MyIsImRpZCI6IjE3MDJEOE9CWVdXUSIsInNka192ZXJzaW9uIjoiMTAyNCIsInBsYXRmb3JtIjoiYW5kcm9pZCIsInBrZ25hbWUiOiJjb20udGFuZ2UzNjUuaWNhbTM2NSJ9.wzU39c2dqQT8aJQxVaaWKf93GwHleZ8y4qznQbcLD72DqtEAwYTwAYjc5QmkyyVfRp4Hd_mYdbruzu_diFO9AA",
        "expires_in": 3600
    }
}

🟠400错误

🟠401请登录

🟠403禁止访问

🟠404资源不存在

🔴500服务器内部错误

修改于 2026-01-15 02:28:13

解除绑定