# 获取店铺的类目权限详情
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南。
接口英文名:getcategoryrelationdetail
通过类目 ID 获取店铺在该类目下的权限详情,包含审核材料、生效/失效时间和失效原因。
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/shop/ec/category/get_category_relation_detail?access_token=ACCESS_TOKEN
# 云调用
- 本接口不支持云调用。
# 第三方调用
本接口支持第三方平台代微信小店商家调用。第三方服务商调用模式介绍
该接口所属的权限集 id 为:85、129、192
服务商获得其中之一权限集授权后,可通过使用 authorizer_access_token 代微信小店商家进行调用,具体可查看 第三方调用 说明文档。
# 2. 请求参数
# 查询参数 Query String Parameters
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证,可使用 access_token(微信小店商家)、authorizer_access_token(服务商代调用) |
# 请求体 Request Payload
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| category_id | number | 是 | 1234 | 类目 ID |
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 示例 | 说明 |
|---|---|---|---|
| errcode | number | 0 | 错误码 |
| errmsg | string | ok | 错误信息 |
| category_id | number | 1178 | 类目 ID |
| status | number | 2 | 类目状态。1=生效中,2=已失效 |
| uneffective_reason | string | 失效原因 | |
| audit_info | object | 审核材料 | |
| effective_time | number | 1686887176 | 生效时间 |
| uneffective_time | number | 1744296240 | 失效时间 |
| qua_id | number | 0 | 类目资质 ID |
# Res.audit_info Object Payload
审核材料
| 参数名 | 类型 | 示例 | 说明 |
|---|---|---|---|
| level3 | number | 1178 | 类目 ID |
| certificate | array | ["https://example.com/example.png"] | 资质资料 |
| brand_list | objarray | brand_list | |
| baobeihan | array | [] | 报备函 |
| jingyingzhengming | array | [] | 经营证明 |
| jingyingpingtai | string | 淘宝 | 经营平台 |
| zhanghaomingcheng | string | 示例店铺 | 帐号名称 |
| ruzhuzhizhi | array | [] | 入驻证明 |
| daihuokoubei | array | [] | 带货口碑 |
| jingyingliushui | array | [] | 经营流水 |
| buchongcailiao | array | [] | 补充材料 |
| license_group_list | objarray | 证照信息 | |
| commitment_letter_list | array | [] | 承诺函 |
| account_link | string | https://example.com | 账号链接 |
| is_new_apply_cat | boolean | true | 是否为新版证照组申请流程 |
# Res.audit_info.brand_list(Array) Object Payload
brand_list
| 参数名 | 类型 | 示例 | 说明 |
|---|---|---|---|
| brand_id | number | 2100000000 | 品牌 ID |
# Res.audit_info.license_group_list(Array) Object Payload
证照信息
| 参数名 | 类型 | 示例 | 说明 |
|---|---|---|---|
| license_group_id | number | 1 | 证照组 ID |
| license | object | 证照详情 |
# Res.audit_info.license_group_list(Array).license Object Payload
证照详情
| 参数名 | 类型 | 示例 | 说明 |
|---|---|---|---|
| license_id | number | 2 | 证照 ID |
| file_id_list | array | ["https://example.com/example.png"] | 证照材料 |
| license_field_list | objarray | 证照填写字段列表 |
# Res.audit_info.license_group_list(Array).license.license_field_listObject Payload
Object Payload证照填写字段列表
| 参数名 | 类型 | 示例 | 说明 |
|---|---|---|---|
| key | string | audit_license_no | 证照填写字段 key |
| value | string | 12345678901234 | 证照填写字段 value |
# 4. 注意事项
本接口无特殊注意事项
# 5. 代码示例
请求示例
{
"category_id": 1178
}
返回示例
{
"errcode": 0,
"errmsg": "ok",
"category_id": 1178,
"status": 2,
"uneffective_reason": "类目已更新,原类目【运动水壶】已下线",
"audit_info": {
"certificate": ["https://example.com/example.png"],
"brand_list": [
{ "brand_id": 2100000000 }
],
"baobeihan": [],
"jingyingzhengming": [],
"jingyingpingtai": "淘宝",
"zhanghaomingcheng": "示例店铺",
"ruzhuzhizhi": [],
"daihuokoubei": [],
"jingyingliushui": [],
"buchongcailiao": [],
"license_group_list": [
{
"license_group_id": 1,
"license": {
"license_id": 2,
"file_id_list": ["https://example.com/example.png"],
"license_field_list": [
{ "key": "audit_license_no", "value": "12345678901234" }
]
}
}
],
"commitment_letter_list": [],
"account_link": "https://example.com",
"is_new_apply_cat": true
},
"effective_time": 1686887176,
"uneffective_time": 1744296240,
"qua_id": 0
}
# 6. 错误码
以下是本接口的错误码列表,其他错误码可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。
| 错误码 | 错误描述 |
|---|---|
| 9401020 | 参数有误 |
# 7. 适用范围
本接口在不同账号类型下的可调用情况:
| 微信小店 | 小店供货商 |
|---|---|
| ✔ | ✔ |
- ✔:该账号可调用此接口。
- 其他未明确声明的账号类型,如无特殊说明,均不可调用此接口。