獲取商品詳情資訊API介面：1688開放平臺功能解析

Noah_WB發表於2023-11-20
API

隨著網際網路技術的發展，電商平臺已經成為人們購物的主要渠道。在這個背景下，1688開放平臺提供了豐富的API介面，幫助開發者更好地與平臺互動，獲取所需資料。本文將重點關注如何獲取商品詳情資訊的API介面。

一、介面概述

透過1688開放平臺的商品詳情資訊API介面，開發者可以獲取商品的詳細資訊，包括商品名稱、價格、庫存、描述、引數等。這對於電商應用、比價工具、資料分析等方面具有很大價值。使用該介面需要向平臺申請許可權，並遵循相應的呼叫規則。

二、請求引數

在呼叫商品詳情資訊API介面時，需要傳入相應的請求引數。通常包括商品ID、呼叫時間戳、金鑰等。確保傳入的引數準確無誤，以保證介面的正常執行。

1.公共引數

名稱

型別

必須

描述

key

String

是

呼叫key（ ,必須以GET方式拼接在URL中）

secret

String

是

呼叫金鑰

api_name

String

是

API介面名稱（包括在請求地址中）[item_search,item_get,item_search_shop等]

cache

String

否

[yes,no]預設yes，將呼叫快取的資料，速度比較快

result_type

String

否

[json,jsonu,xml,serialize,var_export]返回資料格式，預設為json，jsonu輸出的內容中文可以直接閱讀

lang

String

否

[cn,en,ru]翻譯語言，預設cn簡體中文

version

String

否

API版本

2.請求引數

請求引數：num_iid=610947572360

引數說明：num_iid:1688商品ID
sales_data:&sales_data=1 獲取近30天成交資料
agent:&agent=1 獲取1688分銷代發價格資料

三、響應資料

當請求成功後，API介面會返回相應的響應資料。這些資料通常包括商品的詳細資訊，如商品名稱、價格、庫存、描述、引數等。開發者可以根據實際需求，解析並處理這些資料，以實現相應的功能。

Version: Date:


名稱

型別

必須

示例值

描述

item

item[]

0


寶貝詳情資料

num_iid

String

0


寶貝ID

title

String

0


商品標題

desc_short

String

0


商品簡介

price

Float

0


價格

total_price

Float

0



suggestive_price

Float

0



orginal_price

Float

0


原價

nick

String

0


賣家暱稱

num

Int

0



detail_url

String

0


寶貝連結

pic_url

String

0


寶貝圖片

brand

String

0


品牌

brandId

Int

0


品牌id

rootCatId

Int

0


頂 級分類ID

cid

Int

0



desc

String

0



item_imgs

Mix

0


商品圖片

item_weight

String

0



post_fee

Float

0


郵費

express_fee

Float

0


EMS費用

ems_fee

Float

0


物流費用

shipping_to

String

0


發貨至

video

video[]

0


商品影片

sample_id

String

0



props_name

String

0


商品屬性名

prop_imgs

prop_imgs[]

0


商品屬性圖片列表

property_alias

String

0


屬性別名

props

Mix

0


商品詳情

total_sold

Int

0



scale

Int

0



sellUnit

Int

0



skus

skus[]

0


商品規格資訊列表

seller_id

Int

0


賣家ID

sales

Int

0


銷售額

shop_id

Int

0


店鋪ID

props_list

Mix

0


商品屬性

seller_info

seller_info[]

0


賣家資訊

tmall

Boolean

0


是否天貓

data_from

String

0


錯誤資訊

error

String

0


錯誤資訊

unit

String

0


單位

is_support_mix

Boolean

0



mix_amount

Int

0



mix_Begin

Int

0



mix_number

Int

0



sales_data

Date

0



location

String

0


發貨地

props_img

Mix

0


屬性圖片

sales_info

Mix

0



desc_img

Mix

0


詳情圖片列表

shop_item

Mix

0



relate_items

Mix

0



四、呼叫示例與程式碼解析

以下是呼叫商品詳情資訊API介面的示例程式碼：

import requests
def get_product_detail(product_id, timestamp, api_key):
    url = f"https://api.1688.com/product/detail?productId={product_id}×tamp={timestamp}&apiKey={api_key}"
    response = requests.get(url)
    if response.status_code == 200:
        return response.json()
    else:
        return None
-- 請求示例 url 預設請求引數已經URL編碼處理
curl -i "https://api-gw.onebound.cn/1688/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=610947572360"

響應示例

{
	"item": {
		"num_iid": "610947572360",
		"title": "廠家直銷小米有品Qin2 Pro智慧手機學生機老人機備用機小愛同學4G",
		"desc_short": "",
		"price": "799.00",
		"total_price": 0,
		"suggestive_price": 0,
		"orginal_price": "799.00",
		"nick": "qin多親科技",
		"num": "1763",
		"detail_url": "https://detail.1688.com/offer/610947572360.html",
		"pic_url": "
		"brand": "",
		"brandId": "",
		"rootCatId": "",
		"cid": "50903",
		"desc": "<div id=\"offer-template-0\"></div><p><span><span>深圳市多親科技有限公司（簡稱“多親科技”)成立於2014年9月是國內領先的人工智慧硬體解決方案供應商。多親科技積極推動人工智慧技術的創新研發，在人工智慧終端裝置、系統軟體的研發和生產領域，具有深厚的技術沉澱與實力。</span></span></p><p><span> </span></p><p><span>        多親產品銷售網路覆蓋全國各地乃至遠銷海外，歡迎企業定製、團購、經銷代理。</span></p><p><span>        優質的產品、過硬的技術、完善的服務、是我們合作雙贏的開篇。</span></p><p><span>        <span ><strong><span >歡迎有意向者實地考察，垂詢電話：13662284449.</span></strong></span></span></p><p><span> </span></p><p><span>溫馨提示：</span></p><p><span><span><span>1、可定製--</span></span>承接各種訂單訂製！為客戶定製機身、開機畫面、預裝軟體、包裝等定製！</span><br /><span><span><span>2、質量保證--</span></span>本公司專注通訊行業10年，線下線下百花齊放，客戶復購率達30%以上。</span><br /><span><span><span>3、價格實惠--</span></span>本店是工廠直供，沒有中間商差價，一站到客，薄利多銷。</span><br /><span><span><span>4、售後服務--</span></span>本店出售的所有產品均提供1年的質保。因質量原因退換貨（非人為因素）30天內換新。</span></p><p> </p><p><span><img alt=\"undefined\" height=\"446.22866894197955\" src=\"\" width=\"790\" /><br /><img alt=\"undefined\" height=\"457.5154730327144\" src=\"\" width=\"790\" /><br /><img alt=\"undefined\" height=\"443.2365499573014\" src=\"\" width=\"790\" /><br /><img alt=\"undefined\" height=\"440.350569675723\" src=\"\" width=\"790\" /><br /></span></p><p><img alt=\"undefined\" src=\"\" /></p><p><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><br /></p><p><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /></p><p><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /></p><p><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><br /></p>",
		"item_imgs": [
			{
				"url": "
			},
			{
				"url": "
			},
			{
				"url": "
			},
			{
				"url": "
			},
			{
				"url": "
			}
		],
		"item_weight": "",
		"post_fee": "",
		"express_fee": "",
		"ems_fee": "",
		"shipping_to": "",
		"video": [],
		"sample_id": "",
		"props_name": "0:0:機身記憶體:64GB;1:0:顏色:鐵灰色;1:1:顏色:瓷白色",
		"prop_imgs": {
			"prop_img": []
		},
		"property_alias": "0:0:64GB;1:0:鐵灰色;1:1:瓷白色",
		"props": [
			{
				"name": "品牌",
				"value": "多親"
			},
			{
				"name": "型號",
				"value": "Qin 2 Pro"
			},
			{
				"name": "手機型別",
				"value": "老人手機"
			},
			{
				"name": "外形",
				"value": "直板"
			},
			{
				"name": "主屏尺寸",
				"value": "大螢幕(5.0英寸—5.9英寸)"
			},
			{
				"name": "網路制式",
				"value": "移動4G(TD-LTE),聯通/電信4G(FDD-LTE)"
			},
			{
				"name": "作業系統",
				"value": "Android 9.0系統"
			},
			{
				"name": "電池容量",
				"value": "2100"
			},
			{
				"name": "攝像頭畫素",
				"value": "1200萬-1999萬"
			},
			{
				"name": "儲存卡",
				"value": "支援儲存卡"
			},
			{
				"name": "處理器核心",
				"value": "八核"
			},
			{
				"name": "執行記憶體",
				"value": "2GB"
			},
			{
				"name": "手機版本",
				"value": "大陸行貨"
			},
			{
				"name": "售後型別",
				"value": "全國聯保"
			},
			{
				"name": "上市時間",
				"value": "2019"
			},
			{
				"name": "適用送禮場合",
				"value": "員工福利,頒獎紀念,廣告促銷,節日,展銷會,公關策劃,生日,商務饋贈"
			},
			{
				"name": "3C證書編號",
				"value": "2019161606319519"
			},
			{
				"name": "CPU品牌",
				"value": "展訊"
			},
			{
				"name": "運營商",
				"value": "中國移動,中國電信,中國聯通"
			},
			{
				"name": "網路模式",
				"value": "單卡單模"
			},
			{
				"name": "機身記憶體",
				"value": "64GB"
			},
			{
				"name": "顏色",
				"value": "鐵灰色,瓷白色"
			},
			{
				"name": "電信裝置進網許可證編號",
				"value": "02-B613-192425"
			}
		],
		"total_sold": "1",
		"scale": "",
		"sellUnit": "",
		"skus": {
			"sku": [
				{
					"price": "799.00",
					"total_price": 0,
					"sales": "55",
					"properties": "0:0;1:1",
					"properties_name": "0:0:機身記憶體:64GB;1:1:顏色:瓷白色",
					"quantity": "932",
					"sku_id": "4309097072612",
					"spec_id": "63828b15ad641fdb131775f32e4c050c"
				},
				{
					"price": "799.00",
					"total_price": 0,
					"sales": "159",
					"properties": "0:0;1:0",
					"properties_name": "0:0:機身記憶體:64GB;1:0:顏色:鐵灰色",
					"quantity": "831",
					"sku_id": "4302217872901",
					"spec_id": "0eb631954bfe8fb00a45824fc6193f2f"
				}
			]
		},
		"seller_id": "2206619673102",
		"sales": 30,
		"shop_id": "",
		"props_list": {
			"0:0": "機身記憶體:64GB",
			"1:0": "顏色:鐵灰色",
			"1:1": "顏色:瓷白色"
		},
		"seller_info": {
			"nick": "qin多親科技",
			"user_num_id": "2206619673102",
			"sid": "b2b-2206619673102e9470",
			"title": "深圳多親科技實力賣場",
			"zhuy": "https://winport.m.1688.com/page/index.html?memberId=b2b-2206619673102e9470",
			"shop_name": "qin多親科技"
		},
		"tmall": "",
		"data_from": "1688app",
		"error": "",
		"unit": "部",
		"is_support_mix": null,
		"mix_amount": null,
		"mix_begin": null,
		"mix_number": null,
		"min_num": "2",
		"sales_data": "",
		"location": "廣東省 深圳市",
		"props_img": [],
		"sales_info": {
			"seller_num": "",
			"repeat_rate_purchase": "",
			"per_capita_purchases": "",
			"comment_num": "",
			"comment_url": ""
		},
		"desc_img": [
			"",
			"",
			"",
			"",
			"",
			"",
			"",
			"",
			"",
			"",
			"",
			"",
			"",
			"",
			"",
			"",
			"",
			"",
			"",
			"",
			"",
			"",
			"",
			"",
			"",
			"",
			"",
			"",
			"",
			"",
			"",
			"",
			"",
			"",
			"",
			"",
			"",
			""
		],
		"shop_item": [],
		"relate_items": []
	},
	"secache": "f75c59301daa3fc1610a8563c998f851",
	"secache_time": 1608276252,
	"secache_date": "2020-12-18 15:24:12",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"error": "",
	"reason": "",
	"error_code": "0000",
	"cache": 0,
	"api_info": "today:12 max:10000",
	"execution_time": 6.65,
	"server_time": "Beijing/2020-12-18 15:24:17",
	"client_ip": "182.111.155.89",
	"call_args": {
		"num_iid": "610947572360",
		"area_id": "440111"
	},
	"api_type": "1688",
	"translate_language": "zh-CN",
	"translate_engine": "google_cn",
	"server_memory": "4.44MB",
	"request_id": "gw-2.5fdc591b3bdb0"
}

異常示例

{
  "error": "item-not-found",
  "reason": "商品沒找到",
  "error_code": "2000",
  "success": 0,
  "cache": 0,
  "api_info": "today:0 max:10000",
  "execution_time": 0.081,
  "server_time": "Beijing/2020-06-10 23:44:00",
  "call_args": [],
  "api_type": "1688",
  "request_id": "15ee0ffc041242"
}

錯誤碼解釋

狀態程式碼(error_code)

狀態資訊

詳細描述

是否收費

0000

success

介面呼叫成功並返回相關資料

是

2000

Search success but no result

介面訪問成功，但是搜尋沒有結果

是

4000

Server internal error

伺服器內部錯誤

否

4001

Network error

網路錯誤

否

4002

Target server error

目標伺服器錯誤

否

4003

Param error

使用者輸入引數錯誤

忽略

4004

Account not found

使用者帳號不存在

忽略

4005

Invalid authentication credentials

授權失敗

忽略

4006

API stopped

您的當前API已停用

忽略

4007

Account stopped

您的賬戶已停用

忽略

4008

API rate limit exceeded

併發已達上限

忽略

4009

API maintenance

API維護中

忽略

4010

API not found with these values

API不存在

忽略

4012

Please add api first

請先新增api

忽略

4013

Number of calls exceeded

呼叫次數超限

忽略

4014

Missing url param

引數缺失

忽略

4015

Wrong pageToken

引數pageToken有誤

忽略

4016

Insufficient balance

餘額不足

忽略

4017

timeout error

請求超時

否

5000

unknown error

未知錯誤

否

五、常見問題與處理方法

在呼叫商品詳情資訊API介面時，可能會遇到一些問題，如請求超時、引數錯誤等。以下是一些常見問題的處理方法：

  1. 請求超時：檢查網路連線是否正常，同時適當增加請求超時時間。
  2. 引數錯誤：仔細核對傳入的請求引數，確保與檔案要求一致。特別注意商品ID、時間戳和API金鑰的準確性。
  3. 返回資料異常：檢查響應資料的狀態碼和內容，分析可能的原因。如有需要，可聯絡1688開放平臺技術支援尋求幫助。

六、總結與展望

透過本文的介紹，我們瞭解瞭如何使用1688開放平臺的商品詳情資訊API介面獲取商品詳細資訊。這一功能對於開發者來說具有很高的實用價值，可以幫助實現電商應用、比價工具、資料分析等多種功能。在未來的發展中，隨著電商平臺的不斷壯大和開放平臺技術的持續進步，我們期待看到更多實用、便捷的API介面出現，為開發者提供更多可能性。


來自 “ ITPUB部落格 ” ，連結：http://blog.itpub.net/70026910/viewspace-2996142/，如需轉載，請註明出處，否則將追究法律責任。

相關文章