一、引言
在數(shù)字化信息時代,對于開發(fā)者和研究人員而言,獲取特定平臺上的商品信息具有重要意義。孔夫子網(wǎng)作為專注于古舊書、藝術(shù)品等文化商品交易的知名平臺,擁有海量的商品資源。通過提供商品列表 API 接口,開發(fā)者能夠方便地集成孔夫子網(wǎng)的商品數(shù)據(jù),用于開發(fā)各類與文化產(chǎn)品相關(guān)的應(yīng)用程序,如古籍檢索工具、文化商品比價系統(tǒng)等。本文檔旨在詳細(xì)介紹孔夫子商品列表 API 接口,包括接口的基本功能、請求與響應(yīng)細(xì)節(jié)以及 Python 請求示例。 供稿者:Taobaoapi2014
二、接口概述
- 接口功能 該接口允許開發(fā)者通過發(fā)送請求獲取孔夫子網(wǎng)上符合特定條件的商品列表信息??梢愿鶕?jù)不同的篩選條件,如商品類別、價格范圍、出版時間等,靈活地獲取所需的商品列表數(shù)據(jù),為進(jìn)一步的數(shù)據(jù)分析和應(yīng)用開發(fā)提供基礎(chǔ)。
- 請求方式 支持 HTTP GET 和 POST 請求方式。GET 請求適用于簡單的參數(shù)傳遞場景,例如僅通過幾個基本參數(shù)獲取商品列表;POST 請求則更適合需要傳遞復(fù)雜參數(shù)或大量數(shù)據(jù)的情況,比如包含多個篩選條件組合以及分頁信息等。
- 請求參數(shù) category(可選):商品類別,例如 “古籍”“文學(xué)書籍”“藝術(shù)畫作” 等。通過指定類別,可以篩選出特定類型的商品。 min_price(可選):最小價格,用于限定商品價格的下限。例如設(shè)置為 10,表示僅獲取價格大于等于 10 元的商品。 max_price(可選):最大價格,用于限定商品價格的上限。例如設(shè)置為 100,表示僅獲取價格小于等于 100 元的商品。 publication_year_start(可選):出版年份起始值,用于篩選出版時間在該年份及之后的商品。例如設(shè)置為 1990,表示獲取 1990 年及以后出版的商品。 publication_year_end(可選):出版年份結(jié)束值,用于篩選出版時間在該年份及之前的商品。例如設(shè)置為 2000,表示獲取 2000 年及以前出版的商品。 page(可選,默認(rèn)值為 1):頁碼,用于分頁獲取商品列表。例如設(shè)置為 2,表示獲取第二頁的商品列表。 per_page(可選,默認(rèn)值為 20):每頁顯示的商品數(shù)量。例如設(shè)置為 50,表示每頁返回 50 條商品信息。
- 響應(yīng)數(shù)據(jù)格式 接口以 JSON 格式返回數(shù)據(jù),示例如下: json
{
"status": "success",
"total_pages": 5,
"current_page": 1,
"total_items": 98,
"items": [
{
"product_id": 123456,
"product_name": "《紅樓夢》(精裝版)",
"price": 80.00,
"author": "曹雪芹",
"publisher": "人民文學(xué)出版社",
"publication_year": 2010,
"thumbnail_url": "https://img.kongfz.com/123456.jpg"
},
{
"product_id": 789012,
"product_name": "《魯迅全集》",
"price": 150.00,
"author": "魯迅",
"publisher": "中華書局",
"publication_year": 2005,
"thumbnail_url": "https://img.kongfz.com/789012.jpg"
}
],
"message": "商品列表獲取成功"
}
status
:表示請求狀態(tài),“success” 代表成功,“failure” 代表失敗。total_pages
:總頁數(shù),根據(jù)商品總數(shù)和每頁顯示數(shù)量計算得出。current_page
:當(dāng)前頁碼。total_items
:符合篩選條件的商品總數(shù)。items
:商品列表數(shù)組,每個元素為一個商品的基本信息。message
:關(guān)于請求結(jié)果的描述信息。
三、Python 請求示例
使用requests庫進(jìn)行 GET 請求示例(獲取古籍類別,價格在 50 - 150 元之間,第一頁,每頁 20 條的商品列表)
python
import requests
封裝好的第三方數(shù)據(jù)商孔夫子平臺接口,復(fù)制鏈接獲取測試。
demo url=http://c0b.cc/R4rbK2 wechat id:Taobaoapi2014
# 孔夫子商品列表API接口地址
url = 'https://api.kongfz.com/product/list'
# 請求參數(shù)
params = {
'category': '古籍',
'min_price': 50,
'max_price': 150,
'page': 1,
'per_page': 20
}
try:
response = requests.get(url, params=params)
if response.status_code == 200:
data = response.json()
print(data)
else:
print(f"請求失敗,狀態(tài)碼: {response.status_code}")
except requests.RequestException as e:
print(f"請求發(fā)生異常: {e}")
請務(wù)必注意,實(shí)際使用中需要根據(jù)孔夫子網(wǎng)開放平臺提供的真實(shí) API 地址和準(zhǔn)確的參數(shù)要求進(jìn)行調(diào)整。同時,可能需要處理身份驗(yàn)證、請求頻率限制等問題,以確保接口調(diào)用的穩(wěn)定性和合法性。