文档中心 > API类目 > 天猫服务商品API

tmall.miniapp.item.query (支付宝小程序,开放商品查询)

天猫和支付宝打通项目中,针对支付宝域,提供商品的查询接口。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
app_name String 可选 alipay-miniapp
  • 默认值:alipay-miniapp
  • 微服务应用名称
    biz_code String 可选 miniapp_itemquery
  • 默认值:miniapp_itemquery
  • 微服务业务Key
    opt_str String 可选 {"topItemIds":"556171646671"} json接口

    响应参数

    名称 类型 示例值 描述
    result StarkResult result
    • └ has_more
    • Boolean
    • has_more
    • └ msg_code
    • String
    • msg_code
    • data
    • Data
    • data
    • data
    • Data
    • data
    • item_list
    • Itemlist []
    • 商品列表
    • huabei
    • Huabei
    • 花呗数据
    • └ installment_price
    • String
    • 分期价
    • └ free_num
    • Number
    • 分期数
    • └ type
    • String
    • 分期类型
    • └ brand_name
    • String
    • 品牌名称
    • base_info
    • Baseinfo
    • 基本信息
    • └ item_id
    • Number
    • 商品ID
    • └ title
    • String
    • 商品名称
    • └ long_title
    • String
    • 长标题
    • └ pic_url
    • String
    • 白底图
    • └ pic_url_m
    • String
    • 主图
    • └ status
    • String
    • 状态
    • price
    • Price
    • 价额
    • └ orig_price
    • String
    • 原价
    • └ acty_price
    • String
    • 活动价
    • material
    • Material
    • 素材
    • └ app_entry_image
    • String
    • 白底图
    • └ success
    • Boolean
    • success
    • └ ip
    • String
    • ip

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TmallMiniappItemQueryRequest req = new TmallMiniappItemQueryRequest();
    req.setAppName("alipay-miniapp");
    req.setBizCode("miniapp_itemquery");
    req.setOptStr("{\"topItemIds\":\"556171646671\"}");
    TmallMiniappItemQueryResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <tmall_miniapp_item_query_response>
        <result>
            <has_more></has_more>
            <msg_code></msg_code>
            <data>
                <data>
                    <item_list>
                        <itemlist>
                            <huabei>
                                <installment_price></installment_price>
                                <free_num></free_num>
                                <type></type>
                                <brand_name></brand_name>
                            </huabei>
                            <base_info>
                                <item_id></item_id>
                                <title></title>
                                <long_title></long_title>
                                <pic_url></pic_url>
                                <pic_url_m></pic_url_m>
                                <status></status>
                            </base_info>
                            <price>
                                <orig_price></orig_price>
                                <acty_price></acty_price>
                            </price>
                            <material>
                                <app_entry_image></app_entry_image>
                            </material>
                        </itemlist>
                    </item_list>
                </data>
            </data>
            <success></success>
            <ip></ip>
        </result>
    </tmall_miniapp_item_query_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部