tencent cloud

API Calling Description

Request method: POST.

Service URL/v3/device/account/batchoperate

The API service address corresponds to the service access point one by one; therefore, please select the service address corresponding to your application service access point.

Feature: this is an async API that is only responsible for task issuance, with real-time operation currently unsupported.

Parameter description

Request parameters

Note：

• As the token append account API was seldom used and confusing to developers, it had been disused since October 26, 2020. If you have used it before, it will be replaced by the Token clearAndAppendAccount API.
• Only one account can be bound to an account type. If multiple accounts are bound to an account type, an account bound later will override the one bound earlier.

Response parameters

Samples

Sample request

• (Disused) Bind a token to one more 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"
                }
            ]
        }
    ]
  }
  

• Bind the token to another account in an overriding manner

  {
    "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"
                }
            ]
        }
    ]
  }
  

• Unbind a token from an 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"
                }
            ]
        }
    ]
  }
  

• Unbind the token from all accounts

  {
    "operator_type": 4,
    "token_list": [
        "token1",
        "token2",
        "token3"
    ]
  }
  

• Unbind an account from all tokens

  {
    "operator_type": 5,
    "account_list": [
        {
            "account": "926@126.com"
        },
        {
            "account": "1527000000"
        }
    ]
  }
  

Response example

Unbind a token from an account

{
    "ret_code": 0,
    "err_msg": "NO_ERROR",
    "result": [
        "0"
    ]
}