移动推送
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 移动推送 > API 文档 > 账号相关接口 > 账号设备绑定查询

账号设备绑定查询

最近更新时间：2024-01-18 17:08:31

我的收藏

本页目录：

接口说明

请求方式：POST。
服务地址/v3/device/account/query
接口服务地址与服务接入点一一对应，请选择与您的应用服务接入点对应的 服务地址。
接口功能：查询 Account 与 Token 的绑定关系。

参数说明

请求参数

参数名
类型
是否必需
参数说明
operator_type
Integer
是
操作类型：
1：根据 Account 批量查询对应 Token
2：根据 Token 查询 Account
account_list
Array
否
当 operator_type = 1 时有效且必填，待查询 Account 列表每个元素含一组 Account 。 具体示例如下：[{"account":"account1"},{"account":"account2","account_type":1}]
token_list
Array
否
当 operator_type = 2 时有效且必填待查询 Token 的列表
account_type
Integer
否
账号类型，选择绑定时的账号类型查询，默认类型为account_type:0，取值可参见 账号类型取值表

响应参数

参数名
类型
参数说明
retCode
Integer
错误码，详细参照 错误码对照表
errMsg
String
错误信息
result
Array
查询批量 Token 或账号对应的操作状态码["0","10110008"]，数组元素类型：string
account_tokens
Array
Account 到 Token 的映射关系数组。示例如下：[{"account":"account1","token_list":["token1","token2"]}{"account":"account2","token_list":["token2","token3"]}]
token_accounts
Array
Token 到 Account 的映射关系数组。示例如下：[{"token":"token1","account_list":[{"account":"926@126.com"},{"account":"1527000000",}]},{"token":"token2","account_list":[{"account":"926@163.com"},{"account":"1527000001"}]}]
result
Array
查询账号对应的操作状态码["0","1008006"]

示例说明

请求示例

- 批量查询 Account 绑定的 Token 关系
{
    "operator_type": 1,
    "account_list": [
        {
            "account": "account1"
        },
        {
             "account": "account2",
             "account_type": 1
        }
    ]
}
- 批量查询 Token 绑定的 Account 关系
{
    "operator_type": 2,
    "token_list": [
        "token1",
        "token2"
    ]
}

返回示例

- 批量查询 Account 绑定的 Token
{
    "retCode": 0,
    "errMsg": "NO_ERROR",
    "result": [
        "0",
        "0"
    ],
    "account_tokens": [
        {
            "account": "account1",
            "account_type": 0,
            "token_list": [
                "token1",
                "token2"
            ]
        },
        {
            "account": "account2",
            "account_type": 0,
            "token_list": [
                "token2",
                "token3"
            ]
        }
    ],
    "token_accounts": null
}
- 批量查询 Token 绑定的 Account
{
    "retCode": 0,
    "errMsg": "NO_ERROR",
    "result": [
        "0",
        "0"
    ],
    "account_tokens": null,
    "token_accounts": [
        {
            "token": "token1",
            "account_list": [
                {
                    "account": "926@126.com",
                    "account_type": 0,
                    "timestamp": 1691656271
                },
                {
                    "account": "1527000000",
                    "account_type": 0,
                    "timestamp": 1691656272
                }
            ]
        },
        {
            "token": "token2",
            "account_list": [
                {
                    "account": "926@163.com",
                    "account_type": 0,
                    "timestamp": 1691656271
                },
                {
                    "account": "1527000001",
                    "account_type": 0,
                    "timestamp": 1691656271
                }
            ]
        }
    ]
}

中国站