淘宝/天猫平台商品详情API接口调用说明
正常為了進行電商平臺淘寶/天貓的API接口調用,首先我們需要做下面幾件事情:
1)開發者注冊一個賬號
2)然后為每個淘寶應用注冊一個應用程序鍵(App Key)
3)下載淘寶/天貓API的SDK并掌握基本的API基礎知識和調用
4)利用SDK接口和對象,傳入AppKey或者必要的時候獲取并傳入SessionKey來進行程序開發
5)利用淘寶/天貓平臺的文檔中心API測試工具,對接口進行測試從而了解返回信息,方便程序獲取。
6 ) 現無需以上五點,可直接點擊注冊獲取Key和secret:
注冊鏈接:http://console.open.onebound.cn/console/?i=lucy
公共參數:
名稱 類型 必須 描述
key String 是 調用key
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版本
響應參數:
名稱 類型 是否隱私 示例值 描述
num_iid Bigint 545828993398 寶貝ID
title String 三刃木折疊刀過安檢創意迷你鑰匙扣鑰匙刀軍刀隨身多功能小刀包郵 寶貝標題
desc_short String 商品簡介
promotion_price Int 優惠價
price Float 25.8 價格
total_price Float 0
suggestive_price Float 0
orginal_price String 25.80 - 91.80 原價
nick String 歡樂購客棧lxq73061 掌柜昵稱
num Int 3836 庫存
min_num Int 0 最小購買數
detail_url String http://item.taobao.com/item.htm?id=545828993398 寶貝鏈接
pic_url String //gd2.alicdn.com/imgextra/i4/2596264565/TB2p30elFXXXXXQXpXXXXXXXXXX_!!2596264565.jpg 寶貝圖片
brand String 三刃木 品牌名稱
brandId Int 8879363 品牌ID
rootCatId Int 50013886 頂級分類ID
cid Int 50014822
favcount Int 0
fanscount Int 0
crumbs Mix [] 導航菜單
created_time String
modified_time String
delist_time String
desc String
item_imgs Mix [{ “url”: “//gd3.alicdn.com/imgextra/i4/2596264565/TB2p30elFXXXXXQXpXXXXXXXXXX_!!2596264565.jpg”} 商品圖片
item_weight String
item_size String
location String 發貨地
express_fee Float 0.00 快遞費用
ems_fee Float EMS費用
post_fee Float 物流費用
shipping_to String 發貨至
has_discount Boolean false 是否有優惠
video Mix [{“pic”: “https://img.alicdn.com/imgextra/i4/1795410438/O1CN01ZORTQ01F6dyavtEur_!!1795410438.jpg”, “url”: “//cloud.video.taobao.com/play/u/1795410438/p/1/e/1/t/8/218504165570.swf”,“type”: “item”}] 商品視頻
is_virtual String
sample_id String 商品風格標識ID
is_promotion Boolean false 是否促銷
props_name String 1627207:1347647754:顏色分類:長方形帶開瓶器+送工具刀卡+鏈子;1627207:1347647753:顏色分類:橢圓形帶開瓶器+送工具刀卡+鏈子; 商品屬性名
prop_imgs Mix {“prop_img”: [ {“properties”: “1627207:1347647754”, “url”: “//gd2.alicdn.com/imgextra/i3/2596264565/TB2.XeblVXXXXXkXpXXXXXXXXXX_!!2596264565.jpg”}]} 商品屬性圖片列表
property_alias String 20509:9974422:36;1627207:28326:紅色;20509:9975710:38;1627207:28326:紅色;20509:9981357:40;1627207:28326:紅色 商品屬性別名
props Mix [{ “name”: “產地”,“value”: “中國” }] 商品詳情
total_sold Int
skus Mix {“sku”: [{“price”: “39”, “total_price”: null, “orginal_price”: “39.00”, “properties”: “1627207:1347647754”, “properties_name”: “1627207:1347647754:顏色分類:長方形帶開瓶器+送工具刀卡+鏈子”, “quantity”: “305”, “sku_id”: “3166598625985”}] 商品規格信息列表
seller_id Int 41572778 賣家ID
sales Int 138 銷量
shop_id Int 59943521 店鋪ID
props_list Mix {20509:9974422: 尺碼:36} 商品屬性
seller_info Mix {“nick”: “歡樂購客棧”, “city”: null, “level”: 12, “bail”: “2000”, “rate”: 96, “score”: “4.8”, “delivery_score”: “4.8”, “item_score”: “4.8”, “shop_type”: null, “user_num_id”: “2596264565”, “sid”: “127203758”, “title”: “歡樂購客棧”, “zhuy”: “//shop127203758.taobao.com”, “company_name”: null, “menu”: [] } 賣家信息
tmall Boolean false 是否天貓
error String 錯誤信息
warning String price_json error;skus miss; 警告信息
url_log Mix []
method String item_tmall:pget_item
promo_type String
props_img Mix 1627207:28326": "//img.alicdn.com/imgextra/i2/2844096782/O1CN01VrjpXt1zyCc9DvERE_!!2844096782.jpg 屬性圖片
shop_item Mix []
relate_items Mix []
錯誤碼解釋
狀態代碼(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接口调用说明的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 简单编程题
- 下一篇: 帝国根目录查阅 帝国CMS根目录一览表