微店商品列表API接口指南

本文介绍关于微店商品列表 API 接口的完整指南，包含前言、接口概述、Python 请求示例和结语四个核心部分，我会按照这个结构为你提供专业、易上手的指南，覆盖接口调用的核心流程，适合编程新手快速理解和使用。

一、前言

微店作为轻量化的电商开店工具，其开放平台提供了一系列 API 接口，方便开发者获取商品、订单、客户等核心数据。本指南聚焦微店商品列表 API，详细讲解接口的调用规范、参数说明，并提供可直接运行的 Python 请求示例，帮助开发者快速实现微店商品列表数据的获取。

二、接口概述

1. 接口基本信息

项目说明

接口名称商品列表查询（goods/list）。

请求方式HTTP/HTTPS GET/POST（推荐 GET）。

授权方式Bearer Token（access_token）。

数据格式请求参数：JSON/Form；返回数据：JSON。

频率限制普通应用：100 次 / 秒。

2. 核心请求参数

参数名是否必填类型说明

access_token是String接口调用凭证（通过授权获取）。

page int 默认 1。

size int 每页条数，默认 20，最大 50。

status否Integer商品状态：0 - 全部、1 - 上架、2 - 下架、3 - 售罄。

keywordString商品名称关键词（模糊搜索）。

category_id否Integer商品分类 ID（精准筛选）。

3. 接口返回参数（核心字段）

参数名类型说明

totalInteger商品总数

listArray商品列表数组

list[].goods_idString商品 ID

list[].titleString商品标题

list[].priceFloat商品售价（元）

list[].stockInteger商品库存

list[].statusInteger商品状态

list[].cover_picString商品封面图 URL

list[].create_timeString商品创建时间

4. 接口调用前提

正式环境：//c0b.cc/R4rbK2 (前往体验接口测试，Taobaoapi2014添加V获取）

授权获取 access_token（需商户授权，或自用应用获取自有凭证）；

确认应用已开通 “商品管理” 相关权限。

三、Python 请求示例

以下是完整的 Python 请求示例，包含接口调用、参数构造、响应解析、异常处理等核心功能，基于 Python 3.7 + 开发，使用requests库发送请求。

1. 安装依赖

pip install requests

2. 完整代码示例

# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__import print_function
import requests
# 请求示例 url 默认请求参数已经做URL编码
url = "micro/item_get/?key=< 您自己的apiKey >&secret=< 您自己的apiSecret >&num_iid=2749499386"
headers = {
    "Accept-Encoding": "gzip",
    "Connection": "close"
}
if __name__ == "__main__":
    r = requests.get(url, headers=headers)
    json_obj = r.json()
    print(json_obj)

3.代码关键说明

请求头构造：Authorization: Bearer {access_token} 是微店 API 的核心授权方式，必须携带，否则接口会返回 401 未授权错误；

参数处理：可选参数（如 category_id）做了非空判断，避免传递无效参数导致接口报错；

异常处理：覆盖了超时、连接失败、接口返回错误等常见场景，保证程序健壮性；

响应解析：优先判断 HTTP 状态码，再判断接口自定义错误码（errcode=0 表示成功），符合 API 调用的最佳实践。

4. 常见问题解决

401 未授权：检查 access_token 是否过期（微店 Token 有效期通常为 7200 秒），需重新获取；

403 禁止访问：确认应用已开通 “商品列表查询” 权限，未开通需在开放平台申请；

参数错误：检查 status 值是否为 0/1/2/3，size 是否超过 50，避免传递非法参数；

返回数据为空：确认 keyword/category_id 是否正确，或店铺内无对应商品。

四、结语

微店商品列表 API 是获取微店商品核心数据的重要入口，本指南提供的 Python 示例覆盖了接口调用的全流程，开发者可直接复用并根据实际需求扩展功能（如多页数据抓取、商品数据持久化、库存监控等）。

审核编辑 黄宇