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

一、前言

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

二、接口概述

1. 接口基本信息

項(xiàng)目說明

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

請(qǐng)求方式HTTP/HTTPS GET/POST（推薦 GET）。

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

數(shù)據(jù)格式請(qǐng)求參數(shù)：JSON/Form；返回?cái)?shù)據(jù)：JSON。

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

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

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

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

page int 默認(rèn) 1。

size int 每頁(yè)條數(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商品售價(jià)（元）

list[].stockInteger商品庫(kù)存

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

list[].cover_picString商品封面圖 URL

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

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

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

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

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

三、Python 請(qǐng)求示例

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

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
# 請(qǐng)求示例 url 默認(rèn)請(qǐng)求參數(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)鍵說明

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

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

異常處理：覆蓋了超時(shí)、連接失敗、接口返回錯(cuò)誤等常見場(chǎng)景，保證程序健壯性；

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

4. 常見問題解決

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

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

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

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

四、結(jié)語(yǔ)

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

審核編輯 黃宇