支付宝

查询圈选标签列表

开发环境

GET

/v3/alipay/merchant/qipan/crowdtag/query

查询人群圈选可使用的圈选标签列表，用于通过标签创建人群使用

错误码

公共错误码

前往查看

业务错误码

状态码	错误码	错误描述	解决方案
400	ILLEGAL_ARGUMENT	参数非法	校验参数
400	SYSTEM_ERROR	系统繁忙	系统异常，稍后重试
400	RPC_RESULT_FAILED	接口调用异常	接口调用异常，稍后重试
400	QIPAN_PRODUCT_NOT_OPENED	商家未开通棋盘密云	签约棋盘密云产品

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'http://dev-cn.your-api-server.com/v3/alipay/merchant/qipan/crowdtag/query' \
--header 'authorization: ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign' \
--header 'alipay-request-id: $requestid' \
--header 'Content-Type: application/json' \
--data-raw ''

响应示例

{
  "select_tag_list": [
    {
      "tag_id": 803,
      "tag_name": "标签名称",
      "category_tag_option_list": [
        {
          "tag_option_category_id": 50,
          "tag_option_category_name": "地域、人生阶段、职业等",
          "tag_option_list": [
            {
              "text": "内蒙古自治区",
              "value": "4281222529912876",
              "children": [
                {
                  "text": "杭州市",
                  "value": "7124179226564116537"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

请求参数

Header 参数

authorization

string

必需

示例值:

ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign

alipay-request-id

string

必需

示例值:

$requestid

Content-Type

string

必需

示例值:

application/json

返回响应

🟢200成功

application/json

Body

select_tag_list

array [object {3}]

必需

棋盘开放圈选查询标签值返回

tag_id

integer

必需

标签id，通过标签创建人群时使用

tag_name

string

必需

地域、人生阶段、职业等

category_tag_option_list

array [object {3}]

分类的标签值列表

可选

修改于 2023-11-22 07:00:38

人群中删除用户

标签圈选创建人群

查询圈选标签列表

错误码#

公共错误码#

业务错误码#

请求参数

返回响应

错误码

公共错误码

业务错误码