通用场景
用于获取普通商品类目
注意：
类目规则: 目前支持三级类目
公共请求参数
业务请求参数
item_type｜商品类型必选string[0,2]
【描述】商品类型
【枚举值】
售卖类（实物）: 1
租赁类（实物）: 2
付费充值/兑换类（虚拟）: 3
【示例值】1
cat_status可选string[0,32]
【描述】返回筛选状态的类目
【枚举值】
已开通: audit_passed
【示例值】audit_passed
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.app.item.allcategory.query&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'biz_content={
"cat_status":"audit_passed",
"item_type":"1"
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
cats｜类目信息可选categoryandparentvo[]
【描述】类目信息
cat_and_parent｜叶子类目与它的父类目必选appxcategoryvo[]
【描述】叶子类目与它的父类目
cat_id｜类目编号必选string(64)
【描述】类目编号
【示例值】88888
cat_name｜类目名称必选string(32)
【描述】类目名称
【示例值】餐饮
cat_level｜类目层级必选number(4)
【描述】类目层级
【示例值】1
item_types｜商品类型必选string[](2)
【描述】商品类型
【枚举值】
售卖类（实物）: 1
租赁类（实物）: 2
付费充值/兑换类（虚拟）: 3
【示例值】["1"]
f_cat_id｜父类目编号可选string(64)
【描述】父类目编号
【示例值】123123
qualification_status｜开通状态可选string(16)
该参数已废弃
请参考cat_status字段获取当前类目的资质状态以及邀约状态等
【描述】开通状态。只有叶子结点有开通状态
【枚举值】
未开通: none_audit
已开通: audit_pass
审核中: auditing
【示例值】none_audit
cat_status｜类目状态可选string(30)
【描述】仅叶子节点有类目状态
【枚举值】
无权限: no_permission
无行业白名单邀约: not_invited
资质未开通: not_licensed
【示例值】audit_passed
响应示例
正常示例
异常示例
{
"alipay_open_app_item_allcategory_query_response": {
"code": "10000",
"msg": "success",
"cats": [
{
"cat_and_parent": [
{
"cat_id": "88888",
"cat_name": "餐饮",
"f_cat_id": "123123",
"cat_level": 1,
"item_types": [
"1"
],
"cat_status": "audit_passed"
}
]
}
]
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| item_category_not_auth | 暂无可管理商品类目，且未授权企信 | 暂无可经营类目，可在支付宝商家平台（服务商请到服务商平台）-小程序-商品管理-类目管理中查看并申请类目权限 |
| item_category_not_exist | 暂无可管理商品类目，已授权企信 | 暂无可经营类目，可在支付宝商家平台（服务商请到服务商平台）-小程序-商品管理-类目管理中查看并申请类目权限 |