本文介紹關(guān)于微店商品列表 API 接口的完整指南，包含前言、接口概述、Python 請求示例和結(jié)語四個核心部分，我會按照這個結(jié)構(gòu)為你提供專業(yè)、易上手的指南，覆蓋接口調(diào)用的核心流程，適合編程新手快速理解和使用。

一、前言

微店作為輕量化的電商開店工具，其開放平臺提供了一系列 API 接口，方便開發(fā)者獲取商品、訂單、客戶等核心數(shù)據(jù)。本指南聚焦微店商品列表 API，詳細(xì)講解接口的調(diào)用規(guī)范、參數(shù)說明，并提供可直接運(yùn)行的 Python 請求示例，幫助開發(fā)者快速實現(xiàn)微店商品列表數(shù)據(jù)的獲取。

二、接口概述

1. 接口基本信息

項目說明

接口名稱商品列表查詢（goods/list）。

請求方式HTTP/HTTPS GET/POST（推薦 GET）。

授權(quán)方式Bearer Token（access_token）。

數(shù)據(jù)格式請求參數(shù)：JSON/Form；返回數(shù)據(jù)：JSON。

頻率限制普通應(yīng)用：100 次 / 秒。

2. 核心請求參數(shù)

參數(shù)名是否必填類型說明

access_token是String接口調(diào)用憑證（通過授權(quán)獲?。?/p>

page int 默認(rèn) 1。

size int 每頁條數(shù)，默認(rèn) 20，最大 50。

status否Integer商品狀態(tài)：0 - 全部、1 - 上架、2 - 下架、3 - 售罄。

keywordString商品名稱關(guān)鍵詞（模糊搜索）。

category_id否Integer商品分類 ID（精準(zhǔn)篩選）。

3. 接口返回參數(shù)（核心字段）

參數(shù)名類型說明

totalInteger商品總數(shù)

listArray商品列表數(shù)組

list[].goods_idString商品 ID

list[].titleString商品標(biāo)題

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

list[].stockInteger商品庫存

list[].statusInteger商品狀態(tài)

list[].cover_picString商品封面圖 URL

list[].create_timeString商品創(chuàng)建時間

4. 接口調(diào)用前提

正式環(huán)境：//c0b.cc/R4rbK2 (前往體驗接口測試，Taobaoapi2014添加V獲?。?/p>

授權(quán)獲取 access_token（需商戶授權(quán)，或自用應(yīng)用獲取自有憑證）；

確認(rèn)應(yīng)用已開通 “商品管理” 相關(guān)權(quán)限。

三、Python 請求示例

以下是完整的 Python 請求示例，包含接口調(diào)用、參數(shù)構(gòu)造、響應(yīng)解析、異常處理等核心功能，基于 Python 3.7 + 開發(fā)，使用requests庫發(fā)送請求。

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 默認(rèn)請求參數(shù)已經(jīng)做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.代碼關(guān)鍵說明

請求頭構(gòu)造：Authorization: Bearer {access_token} 是微店 API 的核心授權(quán)方式，必須攜帶，否則接口會返回 401 未授權(quán)錯誤；

參數(shù)處理：可選參數(shù)（如 category_id）做了非空判斷，避免傳遞無效參數(shù)導(dǎo)致接口報錯；

異常處理：覆蓋了超時、連接失敗、接口返回錯誤等常見場景，保證程序健壯性；

響應(yīng)解析：優(yōu)先判斷 HTTP 狀態(tài)碼，再判斷接口自定義錯誤碼（errcode=0 表示成功），符合 API 調(diào)用的最佳實踐。

4. 常見問題解決

401 未授權(quán)：檢查 access_token 是否過期（微店 Token 有效期通常為 7200 秒），需重新獲??；

403 禁止訪問：確認(rèn)應(yīng)用已開通 “商品列表查詢” 權(quán)限，未開通需在開放平臺申請；

參數(shù)錯誤：檢查 status 值是否為 0/1/2/3，size 是否超過 50，避免傳遞非法參數(shù)；

返回數(shù)據(jù)為空：確認(rèn) keyword/category_id 是否正確，或店鋪內(nèi)無對應(yīng)商品。

四、結(jié)語

微店商品列表 API 是獲取微店商品核心數(shù)據(jù)的重要入口，本指南提供的 Python 示例覆蓋了接口調(diào)用的全流程，開發(fā)者可直接復(fù)用并根據(jù)實際需求擴(kuò)展功能（如多頁數(shù)據(jù)抓取、商品數(shù)據(jù)持久化、庫存監(jiān)控等）。

審核編輯 黃宇