淘寶開發平台TOP API揭秘

産品老司機手把手教寫文檔,10天線上課程,零基礎掌握産品經理必備7大文檔撰寫法。了解一下>

TOP API自淘寶開放平台Beta公測開始,陸續開放了上百次個API,這些API涵蓋了淘寶基本業務,截止發日志當天TOP-API每天的調用量為:1億多次。

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

What?TOP API介紹

TOP API自淘寶開放平台Beta公測開始,陸續開放了上百次個API,這些API涵蓋了淘寶基本業務,截止發日志當天TOP API每天的調用量為:1億多次。針對API的業務、調用角色、訪問級别和功能,可進行4個分類。

l 業務分類

l 角色分類

對應角色主要包括:

clip_image004< clip_image005< clip_image006< clip_image007< clip_image008< clip_image009

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

clip_image010clip_image012clip_image013

依次表示社區應用、媒體應用、淘寶客應用被授權訪問API的角色級别。此三類角色相互獨立,并與上述六類角色之間不存在角色依賴關系,可以和上面6種角色疊加使用。

 

l 訪問級别分類

公開: 表示完全公開性的數據接口,主要是查詢類的API。 例如:taobao.items.get 。 這類API隻需傳入appkey+簽名進行api的調用。

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

隐私數據須用戶登錄: 表示部分公開性的數據接口,主要是查詢類的API。如:taobao.user.get這個接口。 部分字段是隐私的,部分字段是公開的。當隻訪問公開數據時,API調用時,隻需要傳入appkey+簽名進行API調用。 當需要訪問隐私數據時,需要傳入appkey+sessionkey+簽名方式來調用。

l API功能分類

普通數據開放 API:目前已經開放的淘寶基本業務數據的Open API。

頁面流程化API: 是指将一些複雜的業務流程以頁面的形式開放出來。主要包括對安全程度要求較高的頁面和業務流程要求統一的頁面,如淘寶正向交易和反向交易流程。

增量API:通過該類API,開發者可以獲得批量的淘寶變更信息,如商品狀态變更和交易狀态變更。

Notify APITOP将相關開發者訂閱的操作和變更信息,以主動推送方式通知開發者。

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

LMS API任務和統計分析類API,如,任務型批量大量數據查詢,統計報表查詢類API。

TBML:淘寶模闆語言,按理不屬于API,之所以羅列出來,是後續為方便開發者業務開發,将複雜麻煩的業務接口以标簽形式開放,如,類目和銷售屬性接口,可組合接口通過一标簽語言實現。

Why? TOP API實現業務場景

l 大客戶/獨立網店

用戶:此類型客戶其業務經營規模對較大,經營的産品種類、數量較多。但同同類其他企業相比其電子商務方面的信息化程度仍有進一步提高的空間。

市場需求:

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

2. 相對規模較大的成熟企業因為希望提高市場份額、進入新的細分市場、降低銷售成本等原因而希望通過電子商務渠道對産品進行推廣與銷售。

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

l 虛拟社區/網絡休閑遊戲應用

用戶:擁有較大用戶群體的論壇、社區、網絡遊戲。

市場需求:

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

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

3. 廠商可以将遊戲中的虛拟廣告牌、路标、商品換成淘寶客商品,将網遊中的道具與實際商品相結合,進行多渠道促銷。

l 買家/賣家輔助工具

用戶:網商、通過網絡進行購物的消費者。

市場需求:

1. 不同種類的商品,不同規模的商家都需要不同的管理工具、店鋪展現工具。

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

How? TOP API開發

目前提供的普通Open API,在調用時,隻需要解決簽名驗證,如果還需要訪問用戶隐私數據,則還需要用戶綁定獲得SessionKey。

TOP API采用Rest風格,調用一個接口非常簡單,下圖為具體調用的數據訪問過程。下面舉例taobao.items.get接口的調用,将下面鍊接進行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

該鍊接拼裝了接口的系統參數和業務參數,系統參數如:app_key(注冊應用獲得)、format(返回結果格式)、method(調用的接口名稱)和timestamp(調用接口時間戳);應用參數可查看具體的接口的調用參數。

具體調用接口可查看wiki文檔—Open API的調用。

002

Plan? TOP API規劃

下面為TOP API的開放業務路線圖,發布時間點可能會有所調整,想知道具體發布時間點,請留意TOP論壇公告。

003

此外,如果各位開發者發現我們的API不能滿足應用功能需求,或者讓您開發調用不爽的地方,也請您毫無保留的在這篇博客下跟帖回複吧!您的每一條建議我們都會認真聽取,您的支持是我們前進的動力!

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

給作者打賞,鼓勵TA抓緊創作!
評論
歡迎留言讨論~!
  1. 推薦大家用一個免費的估價平台,http://gj.looip.cn/,還是很管用的。不需要注冊,直接進去根據咱們的項目需求勾選就好,當天就能收到反饋郵件了,價格也很到位的。淘寶開發也可以估價哦。

    回複