接口说明
接口英文名称：alipay.open.app.localitem.allcategory.query
请求url：https://openapi.alipay.com/v3/alipay/open/app/item/localcategory/query
请求方式：post
path指该参数为路径参数
query指该参数需在请求url传参
body指该参数需在请求json传参
通用场景
用于获取本地商品类目
公共请求参数
业务请求参数
body参数
item_type｜商品类型可选string[1,32]
【描述】商品类型
【枚举值】
团购券: 1
代金券: 2
次卡: 3
【示例值】1
cat_status｜类目开通状态可选string[0,32]
【描述】返回筛选状态的类目
【枚举值】
已开通: audit_passed
【示例值】audit_passed
常见请求示例
默认示例
curl -x post \
"https://openapi.alipay.com/v3/alipay/open/app/item/localcategory/query" \
-h "authorization: alipay-sha256withrsa app_id=${appid},timestamp=${now},nonce=${uuid},expired_seconds=600,sign=${sign}" \
-h "alipay-request-id: ${requestid}" \
-h "alipay-app-auth-token: ${app_auth_token}" \
-h "content-type: application/json" \
-d '{
"cat_status":"audit_passed",
"item_type":"1"
}'
说明：本示例仅供参考。
公共响应参数
业务响应参数
cats｜类目信息可选localcategoryandparentvo[]
【描述】类目信息
cat_and_parent｜叶子类目与它的父类目必选localappxcategoryvo[]
【描述】叶子类目与它的父类目
cat_id｜类目编号必选string(64)
【描述】类目编号
【示例值】8888
cat_name｜类目名称必选string(32)
【描述】类目名称
【示例值】餐饮
cat_level｜类目层级必选number(4)
【描述】类目层级
【示例值】1
f_cat_id｜父类目编号可选string(64)
【描述】父类目编号
【示例值】66666
item_types｜商品类型可选string[](30)
【描述】商品类型
【枚举值】
团购: 1
代金: 2
【示例值】["1"]
cat_status｜类目状态可选string(30)
【描述】仅叶子节点有类目状态
【枚举值】
无权限: no_permission
无行业白名单邀约: not_invited
资质未开通: not_licensed
【示例值】audit_passed
响应示例
正常示例
异常示例
{
"cats":[
{
"cat_and_parent":[
{
"cat_id":"8888",
"cat_name":"餐饮",
"f_cat_id":"66666",
"cat_level":1,
"item_types":[
"1"
],
"cat_status":"audit_passed"
}
]
}
]
}说明：本示例仅供参考。
公共错误码
业务错误码
| 状态码 | 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|---|
| 400 | system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| 400 | invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| 400 | item_category_not_auth | 暂无可管理商品类目，且未授权企信 | 暂无可经营类目，可在支付宝商家平台（服务商请到服务商平台）-小程序-商品管理-类目管理中查看并申请类目权限 |
| 400 | item_category_not_exist | 暂无可管理商品类目，已授权企信 | 暂无可经营类目，可在支付宝商家平台（服务商请到服务商平台）-小程序-商品管理-类目管理中查看并申请类目权限 |