查询用户的设备列表

开发中

GET

/v2/device/server/user/{user_id}

设备

请求参数

Path 参数

user_id

string

必需

Query 参数

offset

integer

翻页.起始偏移量

必需

示例值:

limit

integer

翻页.每页记录数

必需

示例值:

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

X-Tg-Date

string

必需

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

默认值:

20060102T150405Z

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET '/v2/device/server/user/?offset=0&limit=10' \
--header 'X-Tg-App-Id;' \
--header 'Accept-Language;' \
--header 'X-Tg-Date;'

返回响应

🟢200成功

application/json

Body

code

integer

必需

示例值:

200

data

object

必需

items

array [object {3}]

必需

total

integer

必需

示例值:

示例

{
    "code": 64,
    "data": {
        "items": [
            {
                "bind_time": "2023-07-03 11:21:16",
                "is_owner": true,
                "device_id": "1702D8OBYWWQ"
            }
        ],
        "total": 1
    }
}

🟠400错误

🟠401请登录

🟠403禁止访问

🟠404资源不存在

🔴500服务器内部错误

修改于 2025-03-29 11:33:24