开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
文档中心
邀测站点 
小程序商品
接入指南
api 列表
普通商品
本地生活商品
商品管理
凭证管理
酒店日历房
支付宝文件
商品变更相关
商品营销相关
相关资料
 >  >  >  > 获取本地商品类目接口

获取本地商品类目接口 -凯发app官方网站

已更新
收藏
订阅更新
我的文档
设置
用于获取本地商品类目

公共请求参数

参数类型是否必选最大长度描述示例值
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
常见请求示例
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 'biz_content={
	"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版本”进行访问。
网站地图