查询标签组信息
开发环境
开发环境
POST
https://open.douyin.com/api/trade_basic/v1/developer/tag_query/
在下单之前，查看接入规范，选择此单售卖商品类型所对应的tag_group_id进行下单。
tag_group_id枚举见下方示例，开发者也可以不调用接口直接根据实际场景进行选用。
错误码
| 错误码 | 错误提示 | 建议解决方案 |
|---|---|---|
| 10000 | 参数错误 | 对照错误提示和接口字段定义，检查对应的参数 |
| 13000 | 系统错误 | 请重试，若多次重试仍然报错，请联系oncall |
| 13002 | 小程序行业暂不支持查询标签及规则 | 小程序所属行业暂不支持接入通用交易系统，可联系运营确认 |
tag_group_id枚举
| 行业 | 商品类型 | tag_group_id | 标签 | 标签说明 | 退款规则 |
|---|---|---|---|---|---|
| 通信 | 号卡商品 | tag_group_7272625659887943692 | 未制卡全额退 制卡后协商退 | 未制卡全额退： 号码实名定制前可全额退款 制卡后协商退： 号码制卡完成后如有特殊退款诉求可与卖家协商退款，号码一经激活将不再支持退款 | 「待履约」 时全额退，无需商户审核 「履约中」时协商退，需要商户审核 「履约完成」时不可退，无需商户审核 |
| 定制服务 | tag_group_7272625659887960076 | 未制作全额退 定制后协商退 | 未制作全额退： 定制类服务未受理制作前可全额退款 定制后协商退： 开始定制后如有特殊退款诉求可与卖家协商退款，定制完成交付后将不再支持退款 | 「待履约」时全额退，无需商户审核 「履约中」时协商退，需要商户审核 「履约完成」时不可退，无需商户审核 | |
| tag_group_7272625659887976460 | 未制作全额退 定制后不可退 | 未制作全额退： 定制类服务未受理制作前可全额退款 定制后不可退： 开始定制后不支持无理由退款 | 「待履约」时全额退，无需商户审核 「履约中」时不可退，无需商户审核 「履约完成」时不可退，无需商户审核 | ||
| 虚拟充值 | tag_group_7272625659887992844 | 不可退 | 充值类商品不支持退款 | 支付后不可退，无需商户审核 | |
| 咨询 | 普通咨询 | tag_group_7272625659888009228 | 未服务全额退 开始服务后协商退 | 未服务全额退： 服务开始前可全额退款 开始服务后协商退： 服务过程中如有特殊退款诉求可与卖家协商退款，服务完成后将不再支持退款 | 「待履约」时全额退，无需商户审核 「履约中」时协商退，需要商户审核 「履约完成」时不可退，无需商户审核 |
| tag_group_7272625659888025612 | 未服务全额退 开始服务后不可退 | 未服务全额退： 服务开始前可全额退款 开始服务后不可退： 服务开始后不支持退款 | 「待履约 」时全额退，无需商户审核 「履约中」时不可退，无需商户审核 「履约完成」时不可退，无需商户审核 | ||
| 代写文书 | tag_group_7297888175123382299 | 未服务全额退 开始服务后协商退 | 未服务全额退： 服务开始前可全额退款 开始服务后协商退： 服务过程中如有特殊退款诉求可与卖家协商退款，服务完成后将不再支持退款 | 「待履约」时全额退，无需商户审核 「履约中」时协商退，需要商户审核 「履约完成」时不可退，无需商户审核 | |
| 内容消费 | 内容充值 | tag_group_7272625659888041996 | 不可退 | 虚拟商品不支持退款 | 支付后即不可退，无需商户审核 |
| 工具 | 虚拟服务 | tag_group_7272625659888058380 | 不可退 | 虚拟商品不支持退款 | 支付后即不可退，无需商户审核 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open.douyin.com/api/trade_basic/v1/developer/tag_query/' \
--header 'Content-Type: application/json' \
--data-raw '{
"goods_type": 101
}'响应示例响应示例
200 - 示例 1
{
"data": {
"tag_detail_list": [
{
"tag_group_id": "string",
"rule_list": [
{
"refund_rule": {
"biz_status": "string",
"merchant_audit_type": 0,
"refund_type": 0
},
"rule_id": "string",
"rule_type": 0
}
],
"tag_list": [
{
"biz_line": 0,
"goods_type": 0,
"tag_descs": [
"string"
],
"tag_id": "string",
"tag_name": "string",
"tag_type": 0
}
]
}
]
},
"err_msg": "string",
"err_no": 0,
"log_id": "string"
}请求参数
Body 参数application/json
返回响应
修改于 2023-11-30 07:56:53