查询用户已授权呼叫微信小程序的设备列表

请求参数

Query 参数

user_id

string

探鸽用户ID

必需

示例值:

34

device_id

string

可选

设备ID，可选，批量查询时，逗号分隔

示例值:

1702D8OBYWWQ

last_id

integer

可选

翻页时用到，传0查询第一页，取上一页的最后一个id

示例值:

0

limit

integer

可选

每页数据条数，默认11，不超过1000

示例值:

1000

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）

默认值:

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

X-Tg-Content-Sha256

string

必需

将BODY数据进行SHA256计算后的值

X-Tg-Algorithm

string

必需

目前服务端接口使用的签名算法的版本号和哈希算法

默认值:

TGV1-HMAC-SHA256

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request GET 'https://openapi-cn01.tange365.com/v2/wx-voip/server/user/devices?user_id=34&device_id=1702D8OBYWWQ&last_id=0&limit=1000' \
--header 'X-Tg-App-Id;' \
--header 'Accept-Language;' \
--header 'Authorization;' \
--header 'X-Tg-Signed-Headers;' \
--header 'X-Tg-Date;' \
--header 'X-Tg-Content-Sha256;' \
--header 'X-Tg-Algorithm;'

返回响应

🟢200成功

application/json

Body

code

integer

错误码

必需

200表示成功

msg

string

错误描述

必需

data

object

数据

必需

成功时返回的数据

items

array [object {12}]

设备列表

必需

total

integer

设备总数

必需

示例

{
  "code": 0,
  "msg": "string",
  "data": {
    "items": [
      {
        "id": 0,
        "device_id": "string",
        "user_id": 0,
        "wxa_app_id": "string",
        "wxa_model_id": "string",
        "wxa_flavor": "string",
        "wxa_user_openid": "string",
        "wxa_nickname": "string",
        "wxa_avatar_url": "string",
        "status": 0,
        "create_at": 0,
        "update_at": 0
      }
    ],
    "total": 0
  }
}

🟠400错误

🟠401请登录

🟠403禁止访问

🟠404资源不存在

🔴500服务器内部错误