淘寶開發(fā)平臺TOP API揭秘

4 評論 45846 瀏覽 12 收藏 11 分鐘

TOP API自淘寶開放平臺Beta公測開始,陸續(xù)開放了上百次個API,這些API涵蓋了淘寶基本業(yè)務(wù),截止發(fā)日志當(dāng)天TOP-API每天的調(diào)用量為:1億多次。

TOP-API淘寶開放平臺Open-API,TOP-API并不是神秘,本文將一層層揭開其面紗,相信通過本日志的表述,作為TOP開發(fā)者的您對于TOP-API可以信手拿來,運(yùn)用自如。想要全面掌握某一項事物,大家肯定想了解what、why、how和plan,本文將圍繞這四個方面,整體介紹TOP API,為什么要調(diào)用TOP API,怎么調(diào)用TOP API和TOP API后續(xù)規(guī)劃。

What?TOP API介紹

TOP API自淘寶開放平臺Beta公測開始,陸續(xù)開放了上百次個API,這些API涵蓋了淘寶基本業(yè)務(wù),截止發(fā)日志當(dāng)天TOP API每天的調(diào)用量為:1億多次。針對API的業(yè)務(wù)、調(diào)用角色、訪問級別和功能,可進(jìn)行4個分類。

l 業(yè)務(wù)分類

l 角色分類

對應(yīng)角色主要包括:

clip_image004< clip_image005< clip_image006< clip_image007< clip_image008< clip_image009

依次表示公開查詢應(yīng)用、買家應(yīng)用、賣家應(yīng)用、商家應(yīng)用、高級應(yīng)用、專業(yè)應(yīng)用被授權(quán)訪問API的角色級別。其中公開查詢應(yīng)用為最低權(quán)限集合級別、專業(yè)應(yīng)用為最高權(quán)限集合級別。查、買、賣接口無需審批,僅受默認(rèn)流量規(guī)則限制,商家以上接口,淘寶商城用戶可以為自己申請商家應(yīng)用角色。ISV及第三方開發(fā)者如需要申請,請看審核規(guī)則。

clip_image010clip_image012clip_image013

依次表示社區(qū)應(yīng)用、媒體應(yīng)用、淘寶客應(yīng)用被授權(quán)訪問API的角色級別。此三類角色相互獨(dú)立,并與上述六類角色之間不存在角色依賴關(guān)系,可以和上面6種角色疊加使用。

l 訪問級別分類

公開: 表示完全公開性的數(shù)據(jù)接口,主要是查詢類的API。 例如:taobao.items.get 。 這類API只需傳入appkey+簽名進(jìn)行api的調(diào)用。

須用戶登錄: 表示完全隱私的數(shù)據(jù)查詢接口以及操作性API。 如:taobao.item.add(操作類API) 或 taobao.item.onsale.get(查詢)。 這類API調(diào)用時,必須傳入appkey+sessionkey+簽名進(jìn)行API的調(diào)用。

隱私數(shù)據(jù)須用戶登錄: 表示部分公開性的數(shù)據(jù)接口,主要是查詢類的API。如:taobao.user.get這個接口。 部分字段是隱私的,部分字段是公開的。當(dāng)只訪問公開數(shù)據(jù)時,API調(diào)用時,只需要傳入appkey+簽名進(jìn)行API調(diào)用。 當(dāng)需要訪問隱私數(shù)據(jù)時,需要傳入appkey+sessionkey+簽名方式來調(diào)用。

l API功能分類

普通數(shù)據(jù)開放 API:目前已經(jīng)開放的淘寶基本業(yè)務(wù)數(shù)據(jù)的Open API。

頁面流程化API: 是指將一些復(fù)雜的業(yè)務(wù)流程以頁面的形式開放出來。主要包括對安全程度要求較高的頁面和業(yè)務(wù)流程要求統(tǒng)一的頁面,如淘寶正向交易和反向交易流程。

增量API:通過該類API,開發(fā)者可以獲得批量的淘寶變更信息,如商品狀態(tài)變更和交易狀態(tài)變更。

Notify APITOP將相關(guān)開發(fā)者訂閱的操作和變更信息,以主動推送方式通知開發(fā)者。

如,淘寶用戶信息變更、淘寶類目變更等。

LMS API任務(wù)和統(tǒng)計分析類API,如,任務(wù)型批量大量數(shù)據(jù)查詢,統(tǒng)計報表查詢類API。

TBML:淘寶模板語言,按理不屬于API,之所以羅列出來,是后續(xù)為方便開發(fā)者業(yè)務(wù)開發(fā),將復(fù)雜麻煩的業(yè)務(wù)接口以標(biāo)簽形式開放,如,類目和銷售屬性接口,可組合接口通過一標(biāo)簽語言實現(xiàn)。

Why? TOP API實現(xiàn)業(yè)務(wù)場景

l 大客戶/獨(dú)立網(wǎng)店

用戶:此類型客戶其業(yè)務(wù)經(jīng)營規(guī)模對較大,經(jīng)營的產(chǎn)品種類、數(shù)量較多。但同同類其他企業(yè)相比其電子商務(wù)方面的信息化程度仍有進(jìn)一步提高的空間。

市場需求:

1. 由中小網(wǎng)商成長起來的客戶為了提高其競爭力,為客戶提供獨(dú)特的購物體驗,逐步建立自身的品牌優(yōu)勢, 希望能夠建立自己的外部網(wǎng)店。

2. 相對規(guī)模較大的成熟企業(yè)因為希望提高市場份額、進(jìn)入新的細(xì)分市場、降低銷售成本等原因而希望通過電子商務(wù)渠道對產(chǎn)品進(jìn)行推廣與銷售。

3. 因為建立覆蓋企業(yè)業(yè)務(wù)前端(市場、銷售)到后端(采購、財務(wù)、物流)的整套電子商務(wù)系統(tǒng)前期投入較大,且系統(tǒng)實施周期相對較長,對于銷售收益前景尚不確定的企業(yè)而言是一項風(fēng)險較大的投資行為。

l 虛擬社區(qū)/網(wǎng)絡(luò)休閑游戲應(yīng)用

用戶:擁有較大用戶群體的論壇、社區(qū)、網(wǎng)絡(luò)游戲。

市場需求:

1. 廣大論壇、SNS社區(qū)渴望將流量變現(xiàn),與此同時廣大商家也期望論壇社區(qū)高價值流量能夠帶來成交和新客戶。

2. 廠商希望通過論壇、社區(qū)展示其商品信息和購買方式,并促進(jìn)用戶通過簡單的操作在論壇、社區(qū)上進(jìn)行即時購買行為。

3. 廠商可以將游戲中的虛擬廣告牌、路標(biāo)、商品換成淘寶客商品,將網(wǎng)游中的道具與實際商品相結(jié)合,進(jìn)行多渠道促銷。

l 買家/賣家輔助工具

用戶:網(wǎng)商、通過網(wǎng)絡(luò)進(jìn)行購物的消費(fèi)者。

市場需求:

1. 不同種類的商品,不同規(guī)模的商家都需要不同的管理工具、店鋪展現(xiàn)工具。

2. 普通淘寶買家渴望更好的淘寶購物體驗。

How? TOP API開發(fā)

目前提供的普通Open API,在調(diào)用時,只需要解決簽名驗證,如果還需要訪問用戶隱私數(shù)據(jù),則還需要用戶綁定獲得SessionKey。

TOP API采用Rest風(fēng)格,調(diào)用一個接口非常簡單,下圖為具體調(diào)用的數(shù)據(jù)訪問過程。下面舉例taobao.items.get接口的調(diào)用,將下面鏈接進(jìn)行http訪問或直接瀏覽器訪問,就可以獲得接口的返回值。

http://gw.api.taobao.com/router/rest?app_key=10011201&fields=iid,title,nick,pic_path,cid,price,type,location.city,delist_time,post_fee&format=xml&method=taobao.items.get&q=mp3&timestamp=2009-12-21 20:31:17&v=1.0&sign=67664111FF66F4926EF416DD3F7DE73C

該鏈接拼裝了接口的系統(tǒng)參數(shù)和業(yè)務(wù)參數(shù),系統(tǒng)參數(shù)如:app_key(注冊應(yīng)用獲得)、format(返回結(jié)果格式)、method(調(diào)用的接口名稱)和timestamp(調(diào)用接口時間戳);應(yīng)用參數(shù)可查看具體的接口的調(diào)用參數(shù)。

具體調(diào)用接口可查看wiki文檔—Open API的調(diào)用。

002

Plan? TOP API規(guī)劃

下面為TOP API的開放業(yè)務(wù)路線圖,發(fā)布時間點可能會有所調(diào)整,想知道具體發(fā)布時間點,請留意TOP論壇公告。

003

此外,如果各位開發(fā)者發(fā)現(xiàn)我們的API不能滿足應(yīng)用功能需求,或者讓您開發(fā)調(diào)用不爽的地方,也請您毫無保留的在這篇博客下跟帖回復(fù)吧!您的每一條建議我們都會認(rèn)真聽取,您的支持是我們前進(jìn)的動力!

來源:http://blog.open.taobao.com/archives/786

本文由 @聚加互動 原創(chuàng)發(fā)布于人人都是產(chǎn)品經(jīng)理。未經(jīng)許可,禁止轉(zhuǎn)載。

題圖來自 Unsplash,基于CC0協(xié)議。

該文觀點僅代表作者本人,人人都是產(chǎn)品經(jīng)理平臺僅提供信息存儲空間服務(wù)。

更多精彩內(nèi)容,請關(guān)注人人都是產(chǎn)品經(jīng)理微信公眾號或下載App
評論
評論請登錄
  1. nice

    來自江西 回復(fù)
    1. 個人表示贊同

      來自河南 回復(fù)
  2. 推薦大家用一個免費(fèi)的估價平臺,http://gj.looip.cn/,還是很管用的。不需要注冊,直接進(jìn)去根據(jù)咱們的項目需求勾選就好,當(dāng)天就能收到反饋郵件了,價格也很到位的。淘寶開發(fā)也可以估價哦。

    來自上海 回復(fù)
    1. 這啥平臺

      來自天津 回復(fù)