本文介紹關于微店商品列表 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=&secret=&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 示例覆蓋了接口調用的全流程，開發者可直接復用并根據實際需求擴展功能（如多頁數據抓取、商品數據持久化、庫存監控等）。

審核編輯 黃宇