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

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

What？TOP API介紹

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

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

l 角色分類

對(duì)應(yīng)角色主要包括：

< < < < <

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

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

l 訪問(wèn)級(jí)別分類

公開: 表示完全公開性的數(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)用時(shí)，必須傳入appkey+sessionkey+簽名進(jìn)行API的調(diào)用。

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

l API功能分類

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

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

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

Notify API：TOP將相關(guān)開發(fā)者訂閱的操作和變更信息，以主動(dòng)推送方式通知開發(fā)者。

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

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

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

Why? TOP API實(shí)現(xiàn)業(yè)務(wù)場(chǎng)景

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

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

市場(chǎng)需求：

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

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

3. 因?yàn)榻⒏采w企業(yè)業(yè)務(wù)前端(市場(chǎng)、銷售)到后端(采購(gòu)、財(cái)務(wù)、物流)的整套電子商務(wù)系統(tǒng)前期投入較大，且系統(tǒng)實(shí)施周期相對(duì)較長(zhǎng)，對(duì)于銷售收益前景尚不確定的企業(yè)而言是一項(xiàng)風(fēng)險(xiǎn)較大的投資行為。

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

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

市場(chǎng)需求：

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

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

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

l 買家/賣家輔助工具

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

市場(chǎng)需求：

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

2. 普通淘寶買家渴望更好的淘寶購(gòu)物體驗(yàn)。

How? TOP API開發(fā)

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

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

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（注冊(cè)應(yīng)用獲得）、format（返回結(jié)果格式）、method（調(diào)用的接口名稱）和timestamp（調(diào)用接口時(shí)間戳）；應(yīng)用參數(shù)可查看具體的接口的調(diào)用參數(shù)。

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

Plan? TOP API規(guī)劃

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

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

來(lái)源：http://blog.open.taobao.com/archives/786