# 获取店铺的类目权限详情

接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南

接口英文名:getcategoryrelationdetail

通过类目 ID 获取店铺在该类目下的权限详情,包含审核材料、生效/失效时间和失效原因。

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/shop/ec/category/get_category_relation_detail?access_token=ACCESS_TOKEN

# 云调用

  • 本接口不支持云调用。

# 第三方调用

# 2. 请求参数

# 查询参数 Query String Parameters

参数名类型必填示例说明
access_tokenstringACCESS_TOKEN接口调用凭证,可使用 access_token(微信小店商家)、authorizer_access_token(服务商代调用)

# 请求体 Request Payload

参数名类型必填示例说明
category_idnumber1234类目 ID

# 3. 返回参数

# 返回体 Response Payload

参数名类型示例说明
errcodenumber0错误码
errmsgstringok错误信息
category_idnumber1178类目 ID
statusnumber2类目状态。1=生效中,2=已失效
uneffective_reasonstring失效原因
audit_infoobject审核材料
effective_timenumber1686887176生效时间
uneffective_timenumber1744296240失效时间
qua_idnumber0类目资质 ID

# Res.audit_info Object Payload

审核材料

参数名类型示例说明
level3number1178类目 ID
certificatearray["https://example.com/example.png"]资质资料
brand_listobjarraybrand_list
baobeihanarray[]报备函
jingyingzhengmingarray[]经营证明
jingyingpingtaistring淘宝经营平台
zhanghaomingchengstring示例店铺帐号名称
ruzhuzhizhiarray[]入驻证明
daihuokoubeiarray[]带货口碑
jingyingliushuiarray[]经营流水
buchongcailiaoarray[]补充材料
license_group_listobjarray证照信息
commitment_letter_listarray[]承诺函
account_linkstringhttps://example.com账号链接
is_new_apply_catbooleantrue是否为新版证照组申请流程

# Res.audit_info.brand_list(Array) Object Payload

brand_list

参数名类型示例说明
brand_idnumber2100000000品牌 ID

# Res.audit_info.license_group_list(Array) Object Payload

证照信息

参数名类型示例说明
license_group_idnumber1证照组 ID
licenseobject证照详情

# Res.audit_info.license_group_list(Array).license Object Payload

证照详情

参数名类型示例说明
license_idnumber2证照 ID
file_id_listarray["https://example.com/example.png"]证照材料
license_field_listobjarray证照填写字段列表

# Res.audit_info.license_group_list(Array).license.license_field_listObject Payload

证照填写字段列表

参数名类型示例说明
keystringaudit_license_no证照填写字段 key
valuestring12345678901234证照填写字段 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. 适用范围

本接口在不同账号类型下的可调用情况:
微信小店小店供货商
  • ✔:该账号可调用此接口。
  • 其他未明确声明的账号类型,如无特殊说明,均不可调用此接口。