查询标签组信息__抖音开放平台

接口说明

用于查询小程序可用的tag_group_id列表，每个tag_group_id关联对应的标签及规则信息。
在下单之前，查看接入规范，选择此单售卖商品类型所对应的tag_group_id进行下单。
tag_group_id枚举见下方示例，开发者也可以不调用接口直接根据实际场景进行选用。

使用限制

无

基本信息

名称	描述
HTTP URL	https://open.douyin.com/api/trade_basic/v1/developer/tag_query/
HTTP Method	POST
Scope	trade_basic.developer.trade_tag
权限要求	不需要用户授权

请求头

名称	字段类型	是否必填	示例	描述
access-token	String	是	clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ	调用https://open.douyin.com/oauth/client_token/生成的token
content-type	String	是	application/json	固定值"application/json"

请求参数

Body

名称	字段类型	是否必填	示例	描述
goods_type	Enum	否	101	商品类型，枚举值: 101: "号卡商品", 102: "通信定制类商品(彩铃)", 103: "话费/宽带充值类商品" 104: "虚拟运营商靓号" 105: "三大运营商靓号" 106: "标准号卡" 107: "非标准号卡" 201: "通用咨询类商品" 202: "代写文书" 301: "虚拟工具类商品" 302: "信息付费" 401: "内容消费类商品" 详情参见：接入规范

请求示例

curl --location --request POST 'https://open.douyin.com/api/trade_basic/v1/developer/tag_query/' \ 
--header 'Content-Type: application/json' \ 
--header 'access-token: clt.xxx' \ 
--data-raw='{ 
        "goods_type": 101       
}'

响应参数

Body

名称	字段类型	是否必填	示例	描述
err_msg	String	是	success	错误提示信息
err_no	Int32	是	0	状态码 0 代表业务处理成功，具体错误码参见后文错误码章节
log_id	String	是		抖音开放平台统一日志id
data	Struct	否		返回数据信息

响应示例

正常响应示例

{
  "data": {
    "tag_detail_list": [
      {
        "tag_group_id": "tag_group_7267090101199847468",
        "rule_list": [
          {
            "refund_rule": {
              "biz_status": "FULFILL_WAIT",
              "merchant_audit_type": 2,
              "refund_type": 3
            },
            "rule_id": "refund_rule_7267012070992805932",
            "rule_type": 1
          },
          {
            "refund_rule": {
              "biz_status": "FULFILLING",
              "merchant_audit_type": 1,
              "refund_type": 2
            },
            "rule_id": "refund_rule_7267012070992838700",
            "rule_type": 1
          },
          {
            "refund_rule": {
              "biz_status": "FULFILL_DONE",
              "merchant_audit_type": 2,
              "refund_type": 1
            },
            "rule_id": "refund_rule_7267012070992871468",
            "rule_type": 1
          }
        ],
        "tag_list": [
          {
            "biz_line": 2001,
            "goods_type": 101,
            "tag_descs": [
              "号码实名定制前可全额退款"
            ],
            "tag_id": "tag_7267090101199487020",
            "tag_name": "未制卡全额退",
            "tag_type": 1
          },
          {
            "tag_name": "制卡后协商退",
            "tag_type": 1,
            "biz_line": 2001,
            "goods_type": 101,
            "tag_descs": [
              "号码制卡完成后如有特殊退款诉求可与卖家协商退款"
            ],
            "tag_id": "tag_7267090101199519788"
          }
        ]
      }
    ]
  },
  "err_msg": "success",
  "err_no": 0,
  "log_id": "02169279434515800000000000000000000ffff0a9824e43dffea"
}

异常响应示例

{
  "err_no": 28001003,
  "err_msg": "access_token无效",
  "log_id": "02169279431654900000000000000000000ffff0a7079f0ec3552"
}

错误码

http状态码	错误码	错误码描述	排查建议
200	10000	参数错误	对照错误提示和接口字段定义，检查对应的参数
200	13000	系统错误	请重试，若多次重试仍然报错，请联系oncall
200	13002	小程序行业暂不支持查询标签及规则	小程序所属行业暂不支持接入通用交易系统，可联系运营确认

tag_group_id枚举

行业	商品类型	tag_group_id	标签	标签说明	退款规则
通信	号卡商品	tag_group_7272625659887943692	•未发货全额退 •发货后协商退	•未发货全额退：号卡物流发货前可全额退款 •发货后协商退：号卡发货后，激活号卡前可与卖家协商退款	1.「待履约」时全额退，无需商户审核 2.「履约中」时协商退，需要商户审核 3.「履约完成」时不可退，无退款入口
	定制服务	tag_group_7272625659887960076	•未制作全额退 •定制后协商退	1.未制作全额退：定制类服务未受理制作前可全额退款 2.定制后协商退：开始定制后如有特殊退款诉求可与卖家协商退款，定制完成交付后将不再支持退款	1.「待履约」时全额退，无需商户审核 2.「履约中」时协商退，需要商户审核 3.「履约完成」时不可退，无需商户审核
	定制服务	tag_group_7272625659887976460	•未制作全额退 •定制后不可退	1.未制作全额退：定制类服务未受理制作前可全额退款 2.定制后不可退：开始定制后不支持无理由退款	1.「待履约」时全额退，无需商户审核 2.「履约中」时不可退，无需商户审核 3.「履约完成」时不可退，无需商户审核
	虚拟充值	tag_group_7272625659887992844	•不可退	1.充值类商品不支持退款	1.支付后不可退，无需商户审核
	虚拟运营商靓号	tag_group_7272625659887943692	•未发货全额退 •发货后协商退	•未发货全额退：号卡物流发货前可全额退款 •发货后协商退：号卡发货后，激活号卡前可与卖家协商退款	1.「待履约」时全额退，无需商户审核 2.「履约中」时协商退，需要商户审核 3.「履约完成」时不可退，无退款入口
	三大运营商靓号
	标准号卡
	非标准流量卡
咨询	普通咨询	tag_group_7272625659888009228	•未服务全额退 •开始服务后协商退	1.未服务全额退：服务开始前可全额退款 2.开始服务后协商退：服务过程中如有特殊退款诉求可与卖家协商退款，服务完成后将不再支持退款	1.「待履约」时全额退，无需商户审核 2.「履约中」时协商退，需要商户审核 3.「履约完成」时不可退，无需商户审核
	普通咨询	tag_group_7272625659888025612	•未服务全额退 •开始服务后不可退	1.未服务全额退：服务开始前可全额退款 2.开始服务后不可退：服务开始后不支持退款	1.「待履约」时全额退，无需商户审核 2.「履约中」时不可退，无需商户审核 3.「履约完成」时不可退，无需商户审核
	代写文书	tag_group_7297888175123382299	•未服务全额退 •开始服务后协商退	1.未服务全额退：服务开始前可全额退款 2.开始服务后协商退：服务过程中如有特殊退款诉求可与卖家协商退款，服务完成后将不再支持退款	1.「待履约」时全额退，无需商户审核 2.「履约中」时协商退，需要商户审核 3.「履约完成」时不可退，无需商户审核
内容消费	内容充值	tag_group_7272625659888041996	•不可退	1.虚拟商品不支持退款	1.支付后即不可退，无需商户审核
	会员
	虚拟币
	剧集
工具	虚拟服务	tag_group_7272625659888058380	•不可退	1.虚拟商品不支持退款	1.支付后即不可退，无需商户审核

查询标签组信息在线调试

接口说明

使用限制

基本信息

请求头

请求参数

Body

请求示例

响应参数

Body

响应示例

正常响应示例

异常响应示例

错误码

​tag_group_id枚举​

查询标签组信息

tag_group_id枚举