开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
支付产品
私域产品
小程序产品
权限集列表
搜索关键词
搜索直达
收藏
消息
小程序码
小程序服务
订单中心
小程序开发管理
生物核身
交易组件
小程序商品
接入指南
api 列表
普通商品
本地生活商品
商品管理
凭证管理
酒店日历房
租房
支付宝文件
商品变更相关
商品营销相关
相关资料
支付有礼
商家粉丝群
营销产品
资金产品
会员产品
信用产品
广告产品
开发 > 服务端 > 私域产品 > 小程序产品 > 权限集列表 > 小程序商品 > api 列表 > 本地生活商品 > 商品管理 > 获取本地商品类目接口
已更新
文档更新记录 >
收藏
订阅更新
我的文档
设置
接入检测
即可查看检测结果)
若有未通过的接入检测项,接口将无法调通
用于获取本地商品类目

公共请求参数

参数类型是否必选最大长度描述示例值
app_idstring必选32
支付宝分配给开发者的应用id
2014072300007148
methodstring必选128
接口名称
alipay.open.app.localitem.allcategory.query
formatstring可选40
仅支持json
json
charsetstring必选10
请求使用的编码格式,如utf-8,gbk,gb2312等
utf-8
sign_typestring必选10
商户生成签名字符串所使用的签名算法类型,目前支持rsa2和rsa,推荐使用rsa2
rsa2
signstring必选344
商户请求参数的签名串,详见签名
详见示例
timestampstring必选19
发送请求的时间,格式"yyyy-mm-dd hh:mm:ss"
2014-07-24 03:07:50
versionstring必选3
调用的接口版本,固定为:1.0
1.0
app_auth_tokenstring可选40
biz_contentstring必选
请求参数的集合,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递,具体参照各产品快速接入文档

业务请求参数

item_type|商品类型可选string[1,32]
【描述】商品类型
【枚举值】
团购券: 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.localitem.allcategory.query&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={
	"cat_status":"audit_passed",
	"item_type":"1"
}' 
说明:本示例仅供参考。

公共响应参数

参数类型是否必选最大长度描述示例值
codestring必选-
网关返回码,
40004
msgstring必选-
网关返回码描述,
business failed
sub_codestring可选-
业务返回码,参见具体的api接口文档
acq.trade_has_success
sub_msgstring可选-
业务返回码描述,参见具体的api接口文档
交易已被支付
signstring必选-
签名,
dzxh8eetuahoye3w1j poiphfdxoybfunn1lket/v7p4zjdyojwea6izs6hz0ydw5cp/viufub5i0/v5wens3oyr8zredqo6d futdlhdc efyckiqhbxizgngpdpdfp1pis7bdhhzrszhbrqb7o4k3dxc aanfauu4v6zdwczo=

业务响应参数

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
响应示例
{
    "alipay_open_app_localitem_allcategory_query_response": {
        "code": "10000",
        "msg": "success",
        "cats": [
            {
                "cat_and_parent": [
                    {
                        "cat_id": "8888",
                        "cat_name": "餐饮",
                        "f_cat_id": "66666",
                        "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暂无可管理商品类目,已授权企信
暂无可经营类目,可在支付宝商家平台(服务商请到服务商平台)-小程序-商品管理-类目管理中查看并申请类目权限
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 2022 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
为开发者能享受更简单的协议处理逻辑、更丰富的开源工具配套、更低的接口响应时延,支付宝开放平台推出符合oas3.0规范的,助力开发体验。新版本文档请点击“查看v3版本”进行访问。
网站地图