Query Tag Values

Last updated: 2018-08-07 16:57:52

API Description

This API (GetTagValues) is used to query the created tag values in a tag list.

Domain name for API request: tag.api.qcloud.com

Input Parameters

The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, please see Common Request Parameters.

Parameter Name Required Type Description
createUin No Int Creator Uin. A value of 0 or empty value means only the current Uin is used for query.
tagKeys Yes Int Tag key list
page No Int Page number. Default is 1.
rp No String Page size. Default is 15.

Output Parameters

Parameter Name Type Description
total Int Total number of results
page Int Current page number
rp Int Page size
rows Array Tag list

The parameters of the array rows are as follows:

Parameter Name Type Description
tagKey String Tag key
tagValue String Tag value

Error Codes

Error Code Description
30001 The tag key does not exist
30004 The main account Uin does not exist

Example

Input example

https://domain/v2/index.php?Action=GetTags&tagKeys.0=testTagKey1&tagKeys.1=testTagKey2&<Common request parameters>

Output example

{
    "total": 2,
    "page": "1",
    "rp": "15",
    "rows": [
        {
            "tagKey": "testTagKey1",
            "tagValue": "testTagVal1"
        },
        {
            "tagKey": "testTagKey2",
            "tagValue": "testTagVal2"
        }
    ]
}