淘寶Open API初學者入門教程
我也使用淘寶Open API也大半年了。不過了,由于阿里軟件的文檔比較的亂,讓很多初學者分不清頭緒(注:淘寶Open API是開放在阿里軟件的一個平臺上,是什么服務集群平臺吧)。當然了,在中國,能夠將自己的服務資源開放出來給第三方使用,特別是淘寶網這種大型商業網站來說,阿里巴巴的這種分享精神和開放的胸懷還是令人佩服的。因此在使用Open API過程中,我們如果覺得資料不是很充分,也不要過多的抱怨,開放的同時意味著責任。呵呵!
在這了,趁端午節放假,將我使用淘寶Open API的心得分享出來,先寫一篇簡單的入門教程,也算是分享和開放吧。
通過閱讀阿里軟件提供的文檔,我們對如何調用淘寶Open API有了基本的了解。阿里軟件Open API平臺即服務集成平臺SIP相關的文檔鏈接如下(在使用SIP平臺上的Open API還是先要了解下該平臺的相關策略如安全策略,訪問控制策略等):
http://wiki.isv.alisoft.com/index.php/%E6%9C%8D%E5%8A%A1%E9%9B%86%E6%88%90%E5%B9%B3%E5%8F%B0
服務集群平臺就不多嘮叨了,去上面的文檔地址去看看。我就簡要的講講就我所知道的一些值得注意的地方:
1.淘寶Open API每分鐘訪問的次數是有限制的,好像是400次/分鐘,即一個應用訪問任何一個淘寶API,一分鐘內最多只能訪問400次;
2.在次數方面,除了上面的控制外,還有日訪問次數控制。如果你的應用是上架的,則日訪問量沒有限制;如果你的應用沒有上架,那么一天之內,你訪問淘寶Open API的次數累計起來不能超過1000次。不要有意見哦,人家的資源也是有限的,而且還是免費的。
3.服務集成平臺的api的安全級別分為四類:無安全策略校驗;簽名校驗;用戶授權校驗(包含簽名校驗);可選用戶授權校驗(包含簽名校驗)。淘寶Open API大多都是需要用戶授權的。所謂用戶授權就是應用軟件在操作用戶的淘寶數據時,就需要用戶授權。如淘寶賣家在使用店鋪管理軟件維護自己的店鋪時,淘寶網就需要淘寶賣家對該店鋪軟件進行授權,只有授權了,店鋪管理軟件才能操作淘寶賣家的數據。
4.授權除了上面所描述的外,授權還有時效性。就是授權是有期限的,現在淘寶授權一次的***有效時效為一個小時。如果在一個小時內,沒用調用任何淘寶Open API,則授權過期了,需要重新授權。而對于未上架的應用,授權時效內不管有沒有調用淘寶Open API,授權期限過后就需要重新授權。看來,上架的應用還是有相當大的空間優勢。
其他的就不多嘮叨了,還沒有在阿里軟件注冊應用的,還得先去阿里軟件平臺注冊一個應用,注冊成功后,你會得到APP ID及CERT CODE。其中APP ID是用來標記應用,即你注冊應用的ID,CERT CODE則是你應用的密鑰,在做簽名時用。
下面直接來個demo,感受下淘寶的Open API。我們調用交易類的taobao.trade.get為例,該api文檔地址為:http://isp.alisoft.com/apidoc/api/apiIndex.html#isp_taobao-6-281 。可以知道這個api是用戶授權,即需要用戶授權才可以訪問該用戶的交易信息。
源代碼如下:
package org.openapi.taobao;import java.security.MessageDigest;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.HashMap;
import java.util.Iterator;
import java.util.Map;
import java.util.Set;
import java.util.TreeSet;
import org.apache.commons.httpclient.HttpClient;
import org.apache.commons.httpclient.NameValuePair;
import org.apache.commons.httpclient.methods.PostMethod;
public class TaobaoOpenApiDemo {
/**
* 調用淘寶的taobao.trade.get demo,
* 運行該示例時,你需要將appId,appSecret,tid
* 這三個參數替換為你自己的,就可以運行該demo
*
* 在***次運行時 會提醒你登錄淘寶進行授權,
* 授權成功后 再次運行該demo就可以獲取指定交易的信息 呵呵
*
* 這只是一個簡單的demo,只是為初學者提供方便
* 有了這個原型 大家就可以各顯自己的神通了
*/
public static void main(String[] args) {
// 淘寶Open API平臺即SIP平臺的入口
上面短短的100多行代碼只是向初學者展示如何使用淘寶Open API服務。從代碼也可以看到,基于rest的Open API的確使用起來相當的方便。當然,要想使用好淘寶Open API,還得好好的閱讀淘寶Open API文檔。同時,還需打開自己的思維,使用淘寶Open API編寫出有創意的應用。早日上架,早日盈利!
如果大家有什么問題,可以回復本貼,有問必答。大家相互探討,共同進步。呵呵!
【編輯推薦】