通用场景
商品类目预测咨询接口。平台会通过商品详情页进行采集识别，预测商品类目，此接口为类目预测的结果获取接口。
公共请求参数
业务请求参数
item_type｜商品类型必选string[1,2]
【描述】[{"value": "1","name": "售卖类（实物）"},{"value": "2","name": "租赁类（实物）"},{"value": "3","name": "付费充值/兑换类（虚拟）"}]
【枚举值】
售卖类（实物）: 1
租赁类（实物）: 2
付费充值/兑换类（虚拟）: 3
【示例值】1
title｜商品标题必选string[0,60]
【描述】需要录入的商品的标题
【示例值】苹果
以下参数 二选一 传入必选
path｜商品详情页urlstring[6,256]
【描述】商品详情页url
【示例值】alipays://platformapi/startapp?appid=2021003192615606
img_id｜商品图片string[0,128]
【描述】商品的图片id；获取方式：商品主图&子图&详情图
【示例值】a*phfasaesf_0aaaaaaaaaaaaaatcnaq
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.app.item.category.consult&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'app_auth_token=${app_auth_token}' \
-f 'biz_content={
"item_type":"1",
"path":"alipays://platformapi/startapp?appid=2021003192615606",
"img_id":"a*phfasaesf_0aaaaaaaaaaaaaatcnaq",
"title":"苹果"
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
status｜状态必选boolean(10)
【描述】类目状态。true：类目可用；false：类目不可用
【示例值】true
category_error_desc必选string(30)
【描述】类目不可用原因。例如：无权限；无行业白名单邀约；资质未开通；资质已开通；资质审核中；资质审核驳回；小程序的类目经营范围内没有这些商品类目；未查询到类目。
【示例值】未开通
category_id｜类目id可选string(20)
【描述】商品类目id
【示例值】c001496564
category_name｜类目名称可选string(10)
【描述】商品类目名称
【示例值】笔记本
category_error_code｜错误码可选string(30)
【描述】类目不可用错误码
【枚举值】
无权限: no_permission
无行业白名单邀约: not_invited
资质未开通: not_licensed
【示例值】audit_rejected
cat_level可选number(4)
【描述】类目层级
【示例值】2
响应示例
正常示例
异常示例
{
"alipay_open_app_item_category_consult_response": {
"code": "10000",
"msg": "success",
"category_id": "c001496564",
"category_name": "笔记本",
"status": true,
"category_error_desc": "未开通",
"category_error_code": "audit_rejected",
"cat_level": 2
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| mini_app_not_online | 小程序未上架 | 请先上架当前小程序 |