tencent cloud

文档反馈

账号设备绑定查询

最后更新时间:2024-01-17 14:26:44

    接口说明

    请求方式: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"}]
    token_list
    Array
    当 operator_type = 2 时有效且必填待查询 Token 的列表

    响应参数

    参数名
    类型
    参数说明
    retCode
    Integer
    错误码,详细参照 错误码对照表
    errMsg
    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"}]}]

    示例说明

    请求示例

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

    返回示例

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