账号设备绑定查询

最后更新时间:2021-06-02 17:14:41

    接口说明

    请求方式:POST。

    plaintext
    服务地址/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 关系
      json
      {
       "operator_type": 1,
       "account_list": [
           {
               "account": "account1"
           },
           {
               "account": "account2"
           }
       ]
      }
      
    • 批量查询 Token 绑定的 Account 关系
      json
      {
       "operator_type": 2,
       "token_list": [
           "token1",
           "token2"
       ]
      }
      

    返回示例

    • 批量查询 Account 绑定的 Token
      json
      {
       "retCode": 0,
       "errMsg": "ok",
       "result": [
           "0",
           "0"
       ],
       "account_tokens": [
           {
               "account": "account1",
               "token_list": [
                   "token1",
                   "token2"
               ]
           },
           {
               "account": "account2",
               "token_list": [
                   "token2",
                   "token3"
               ]
           }
       ]
      }
      
    • 批量查询 Token 绑定的 Account
      json
      {
       "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"
                   }
               ]
           }
       ]
      }