tencent cloud

All product documents
APIs
Account and Device Binding Query
Last updated: 2024-01-17 14:26:44
Account and Device Binding Query
Last updated: 2024-01-17 14:26:44

API Description

Request method: POST
Service URL/v3/device/account/query
API service URLs correspond to service access points one to one. Please select the service URL corresponding to the service access point of your application.
Feature: this API is used to query the binding relationships between accounts and tokens.

Parameters

Request parameters

Parameter
Type
Required
Description
operator_type
Integer
Yes
Operation type:
1: Batch query tokens by account
2: Query accounts by token
account_list
Array
No
Account list. This parameter is valid and required when operator_type is 1. Each element of the list contains one set of accounts. Example: [{"account":"account1"},{"account":"account2"}]
token_list
Array
No
Token list. This parameter is valid and required when operator_type is 2.

Response parameters

Parameter
Type
Description
retCode
Integer
Error code. For more information, please see Server-Side Error Codes.
errMsg
String
Error message
account_tokens
Array
Array of mappings from accounts to tokens.
Example:[{"account":"account1","token_list":["token1","token2"]}{"account":"account2","token_list":["token2","token3"]}]
token_accounts
Array
Array of mappings from tokens to accounts
Example:
[{"token":"token1","account_list":[{"account":"926@126.com"},{"account":"1527000000",}]},
{"token":"token2","account_list":[{"account":"926@163.com"},{"account":"1527000001"}]}]

Samples

Sample request

Batch query the relationships of tokens bound to accounts
{
"operator_type": 1,
"account_list": [
{
"account": "account1"
},
{
"account": "account2"
}
]
}
Batch query the relationships of accounts bound to tokens
{
"operator_type": 2,
"token_list": [
"token1",
"token2"
]
}

Sample response

Batch query the tokens bound to accounts
{
"retCode": 0,
"errMsg": "ok",
"result": [
"0",
"0"
],
"account_tokens": [
{
"account": "account1",
"token_list": [
"token1",
"token2"
]
},
{
"account": "account2",
"token_list": [
"token2",
"token3"
]
}
]
}
Batch query the accounts bound to tokens
{
"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"
}
]
}
]
}

Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback

Contact Us

Contact our sales team or business advisors to help your business.

Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

7x24 Phone Support