本文介绍关于微店商品列表 API 接口的完整指南，包含前言、接口概述、Python 请求示例和结语四个核心部分，我会按照这个结构为你提供专业、易上手的指南，覆盖接口调用的核心流程，适合编程新手快速理解和使用。
一、前言
微店作为轻量化的电商开店工具，其开放平台提供了一系列 API 接口，方便开发者获取商品、订单、客户等核心数据。本指南聚焦微店商品列表 API，详细讲解接口的调用规范、参数说明，并提供可直接运行的 Python 请求示例，帮助开发者快速实现微店商品列表数据的获取。
二、接口概述
- 接口基本信息
项目说明
接口名称商品列表查询（goods/list）。
请求方式HTTP/HTTPS GET/POST（推荐 POST）。
授权方式Bearer Token（access_token）。
数据格式请求参数：JSON/Form；返回数据：JSON。
频率限制普通应用：100 次 / 秒。
- 核心请求参数
参数名是否必填类型说明
access_token是String接口调用凭证（通过授权获取）。
page否Integer页码，默认 1。
size否Integer每页条数，默认 20，最大 50。
status否Integer商品状态：0 - 全部、1 - 上架、2 - 下架、3 - 售罄。
keyword否String商品名称关键词（模糊搜索）。
category_id否Integer商品分类 ID（精准筛选）。
- 接口返回参数（核心字段）
参数名类型说明
totalInteger商品总数
listArray商品列表数组
list[].goods_idString商品 ID
list[].titleString商品标题
list[].priceFloat商品售价（元）
list[].stockInteger商品库存
list[].statusInteger商品状态
list[].cover_picString商品封面图 URL
list[].create_timeString商品创建时间
