淘寶Open API初學(xué)者入門教程
我也使用淘寶Open API也大半年了。不過了,由于阿里軟件的文檔比較的亂,讓很多初學(xué)者分不清頭緒(注:淘寶Open API是開放在阿里軟件的一個平臺上,是什么服務(wù)集群平臺吧)。當(dāng)然了,在中國,能夠?qū)⒆约旱姆?wù)資源開放出來給第三方使用,特別是淘寶網(wǎng)這種大型商業(yè)網(wǎng)站來說,阿里巴巴的這種分享精神和開放的胸懷還是令人佩服的。因此在使用Open API過程中,我們?nèi)绻X得資料不是很充分,也不要過多的抱怨,開放的同時意味著責(zé)任。呵呵!
在這了,趁端午節(jié)放假,將我使用淘寶Open API的心得分享出來,先寫一篇簡單的入門教程,也算是分享和開放吧。
通過閱讀阿里軟件提供的文檔,我們對如何調(diào)用淘寶Open API有了基本的了解。阿里軟件Open API平臺即服務(wù)集成平臺SIP相關(guān)的文檔鏈接如下(在使用SIP平臺上的Open API還是先要了解下該平臺的相關(guān)策略如安全策略,訪問控制策略等):
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
服務(wù)集群平臺就不多嘮叨了,去上面的文檔地址去看看。我就簡要的講講就我所知道的一些值得注意的地方:
1.淘寶Open API每分鐘訪問的次數(shù)是有限制的,好像是400次/分鐘,即一個應(yīng)用訪問任何一個淘寶API,一分鐘內(nèi)最多只能訪問400次;
2.在次數(shù)方面,除了上面的控制外,還有日訪問次數(shù)控制。如果你的應(yīng)用是上架的,則日訪問量沒有限制;如果你的應(yīng)用沒有上架,那么一天之內(nèi),你訪問淘寶Open API的次數(shù)累計起來不能超過1000次。不要有意見哦,人家的資源也是有限的,而且還是免費的。
3.服務(wù)集成平臺的api的安全級別分為四類:無安全策略校驗;簽名校驗;用戶授權(quán)校驗(包含簽名校驗);可選用戶授權(quán)校驗(包含簽名校驗)。淘寶Open API大多都是需要用戶授權(quán)的。所謂用戶授權(quán)就是應(yīng)用軟件在操作用戶的淘寶數(shù)據(jù)時,就需要用戶授權(quán)。如淘寶賣家在使用店鋪管理軟件維護(hù)自己的店鋪時,淘寶網(wǎng)就需要淘寶賣家對該店鋪軟件進(jìn)行授權(quán),只有授權(quán)了,店鋪管理軟件才能操作淘寶賣家的數(shù)據(jù)。
4.授權(quán)除了上面所描述的外,授權(quán)還有時效性。就是授權(quán)是有期限的,現(xiàn)在淘寶授權(quán)一次的***有效時效為一個小時。如果在一個小時內(nèi),沒用調(diào)用任何淘寶Open API,則授權(quán)過期了,需要重新授權(quán)。而對于未上架的應(yīng)用,授權(quán)時效內(nèi)不管有沒有調(diào)用淘寶Open API,授權(quán)期限過后就需要重新授權(quán)。看來,上架的應(yīng)用還是有相當(dāng)大的空間優(yōu)勢。
其他的就不多嘮叨了,還沒有在阿里軟件注冊應(yīng)用的,還得先去阿里軟件平臺注冊一個應(yīng)用,注冊成功后,你會得到APP ID及CERT CODE。其中APP ID是用來標(biāo)記應(yīng)用,即你注冊應(yīng)用的ID,CERT CODE則是你應(yīng)用的密鑰,在做簽名時用。
下面直接來個demo,感受下淘寶的Open API。我們調(diào)用交易類的taobao.trade.get為例,該api文檔地址為:http://isp.alisoft.com/apidoc/api/apiIndex.html#isp_taobao-6-281 ??梢灾肋@個api是用戶授權(quán),即需要用戶授權(quán)才可以訪問該用戶的交易信息。
源代碼如下:
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 {
/**
* 調(diào)用淘寶的taobao.trade.get demo,
* 運行該示例時,你需要將appId,appSecret,tid
* 這三個參數(shù)替換為你自己的,就可以運行該demo
*
* 在***次運行時 會提醒你登錄淘寶進(jìn)行授權(quán),
* 授權(quán)成功后 再次運行該demo就可以獲取指定交易的信息 呵呵
*
* 這只是一個簡單的demo,只是為初學(xué)者提供方便
* 有了這個原型 大家就可以各顯自己的神通了
*/
public static void main(String[] args) {
// 淘寶Open API平臺即SIP平臺的入口
上面短短的100多行代碼只是向初學(xué)者展示如何使用淘寶Open API服務(wù)。從代碼也可以看到,基于rest的Open API的確使用起來相當(dāng)?shù)姆奖恪.?dāng)然,要想使用好淘寶Open API,還得好好的閱讀淘寶Open API文檔。同時,還需打開自己的思維,使用淘寶Open API編寫出有創(chuàng)意的應(yīng)用。早日上架,早日盈利!
如果大家有什么問題,可以回復(fù)本貼,有問必答。大家相互探討,共同進(jìn)步。呵呵!
【編輯推薦】