tencent cloud

PrevNext

文档反馈

请输入关键字

Recent Pages

文档
文档

账号绑定与解绑

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

    接口说明

    请求方式：POST。
    服务地址/v3/device/account/batchoperate
    接口服务地址与服务接入点一一对应，请选择与您的应用服务接入点对应的 服务地址。
    接口功能：异步接口。本接口只负责任务下发，当前不支持实时操作。

    参数说明

    请求参数

    参数名
    类型
    是否必需
    参数说明
    operator_type
    Integer
    是
    操作类型参数，取值范围为[1,5]；值对应功能说明如下：
    1：Token 追加设置 account（该类型已废弃）。
    2：Token 覆盖设置 account。
    3：Token 删除绑定的多个 account。
    4：Token 删除绑定的所有 account。
    5： account 删除绑定的所有 Token。
    account_list
    Array
    否
    账号标识集合，当 operator_type = 5 时有效，且必填每个元素包含 account，以及 account_type 字段，加上 account_type 就可以设置类型。 示例如下： [{"account":"926@126.com"},{"account":"1527000000"}，{"account":"2849249569","account_type":9}]
    token_list
    Array
    否
    设备标识集合， operator_type = 4 时有效，且必填
    token_accounts
    Array
    否
    当 operator_type = 1、2 、3 时有效且必须每次调用最多允许设置20个 Token。每个 Token_account 由1个 Token 和1个 account_list 组成。 具体示例如下： [{"token":"token1","account_list":[{"account":"926@126.com"},{"account":"1527000000"}], {"token":"token2","account_list":[{"account":"926@163.com",{"account":"1527000001"}]}]
    account_type
    Integer
    否
    账号类型，绑定时可选择账号类型，默认类型为account_type:0，取值可参考 账号类型取值表
    说明：
    因“Token 追加设置 account”使用率非常低，且容易被开发者误解，从2020年10月26日开始，追加账号接口停止使用。如您此前有使用该接口，该接口功能将变更为“Token 覆盖设置 account”功能。
    一个账号类型只能绑定一个账号，绑定多个账号，后面的账号会覆盖前面绑定的账号。

    响应参数

    参数名
    类型
    参数说明
    ret_code
    Integer
    错误码，详细参照 错误码对照表。
    err_msg
    String
    错误信息
    result
    Array
    每一个 Token 或账号对应的操作状态码["0","1008006"]

    示例说明

    请求示例

    Token 追加设置 Account（该类型已废弃）：
    {
      "operator_type": 1,
      "token_accounts": [
          {
              "token": "token1",
              "account_list": [
                  {
                      "account": "926@126.com"
                  },
                  {
                      "account": "1527000000"
                  }
              ]
          },
          {
              "token": "token2",
              "account_list": [
                  {
                      "account": "926@163.com"
                  },
                  {
                      "account": "1527000001"
                  }
              ]
          }
      ]
    }
    Token 覆盖绑定 Account：
    {
      "operator_type": 2,
      "token_accounts": [
          {
              "token": "token1",
              "account_list": [
                  {
                      "account": "926@126.com"
                  },
                  {
                      "account": "1527000000"
                  }
              ]
          },
          {
              "token": "token2",
              "account_list": [
                  {
                      "account": "926@163.com"
                  },
                  {
                      "account": "1527000001"
                  }
              ]
          }
      ]
    }
    Token 删除绑定 Account：
    {
      "operator_type": 3,
      "token_accounts": [
          {
              "token": "token1",
              "account_list": [
                  {
                      "account": "926@126.com"
                  },
                  {
                      "account": "1527000000"
                  }
              ]
          },
          {
              "token": "token2",
              "account_list": [
                  {
                      "account": "926@163.com"
                  },
                  {
                      "account": "1527000001"
                  }
              ]
          }
      ]
    }
    Token 删除所有绑定 Account：
    {
      "operator_type": 4,
      "token_list": [
          "token1",
          "token2",
          "token3"
      ]
    }
    Account 删除所有绑定 Token：
    {
      "operator_type": 5,
      "account_list": [
          {
              "account": "926@126.com"
          },
          {
              "account": "1527000000"
          }
      ]
    }

    返回示例

    Token 删除绑定 Account：
    {
        "ret_code": 0,
        "err_msg": "NO_ERROR",
        "result": [
            "0"
        ]
    }
    
    Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
    隐私条款服务条款缓存条款