淘宝Open API初学者入门教程

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 {

public static void main(String[] args) {

// 淘宝Open API平台即SIP平台的入口
String sipRequestUrl = "http://sip.alisoft.com/sip/rest";
String appId
= "****"; // 在阿里软件平台注册的应用ID,请使用你自己的应用ID
String appSecret = "******"; // 注册的应用的密钥,请使用你自己应用的密钥
String taobaoApiName = "taobao.trade.get"; // 交易类api
String sessionId = "1234567";//sessionId是isv应用自己生成的字符串
//确保每个使用该应用的用户各自的sessionId各不相同
SimpleDateFormat formater = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");

Map params
= new HashMap();
params.put(
"sip_appkey", appId);
params.put(
"sip_apiname", taobaoApiName);
params.put(
"sip_timestamp", formater.format(new Date()));
params.put(
"sip_sessionid", sessionId);
params.put(
"fields", "seller_nick,buyer_nick,title,type,created,sid");
params.put(
"tid", "******"); //请设置你要查询的交易号
params.put("format", "xml");
params.put(
"v", "1.0");
params.put(
"sip_sign", getSign(appSecret, params));

String result
= requestOpenApi(sipRequestUrl, params);
if (result != null && result.startsWith("sip_isp_loginurl:")) {
result
= result.replaceAll("&", "&");
System.out.println(
"打开浏览器,访问下面的URL进行用户授权,授权成功后" +
",再次运行该类就可以调用api获取交易信息");
System.out.println(result.substring(
"sip_isp_loginurl:".length()));
}
else if (result != null)
System.out.println(result);

}


public static String requestOpenApi(String url, Map params) {
HttpClient client
= new HttpClient();
PostMethod postMethod
= new PostMethod(url);

try {
NameValuePair[] postData
= new NameValuePair[params.size()];

Iterator iters
= params.keySet().iterator();
int i = 0;

while (iters.hasNext()) {
String key
= (String) iters.next();
postData[i]
= new NameValuePair(key, params.get(key).toString());
i
++;
}

postMethod.setRequestBody(postData);
client.executeMethod(postMethod);
String resultCode
= postMethod.getResponseHeader("sip_status")
.getValue();
if (resultCode == null || ("".equals(resultCode)))
return null;
else if ("1004".equals(resultCode))
return "sip_isp_loginurl:"
+ postMethod.getResponseHeader("sip_isp_loginurl")
.getValue();
else if (!"9999".equals(resultCode))
return resultCode
+ ":"
+ postMethod.getResponseHeader("sip_errormessage")
.getValue();

return postMethod.getResponseBodyAsString();

}
catch (Exception ex) {
ex.printStackTrace();
}
finally {
if (postMethod != null)
postMethod.releaseConnection();
}

return null;

}


public static String getSign(String secret, Map params) {
if (secret == null || "".equals(secret) || params == null)
throw new RuntimeException(
"secret or params is null or blank, please check");

StringBuilder sb
= new StringBuilder().append(secret);
String result
= null;

try {
Set sortedKeys
= new TreeSet();
sortedKeys.addAll(params.keySet());
for (String key : sortedKeys)
sb.append(key).append(params.get(key));

MessageDigest md
= MessageDigest.getInstance("MD5");
result
= byteTohex(md.digest(sb.toString().getBytes("utf-8")));

}
catch (Exception e) {
throw new RuntimeException(e);
}

return result;
}

public static String byteTohex(byte[] b) {
StringBuffer sb
= new StringBuffer();
String stmp
= "";

for (int n = 0; n < b.length; n++) {
stmp
= (java.lang.Integer.toHexString(b[n] & 0XFF));

if (stmp.length() == 1)
sb.append(
"0").append(stmp);
else
sb.append(stmp);
}

return sb.toString().toUpperCase();
}
}

 

上面短短的100多行代码只是向初学者展示如何使用淘宝Open API服务。从代码也可以看到,基于rest的Open API的确使用起来相当的方便。当然,要想使用好淘宝Open API,还得好好的阅读淘宝Open API文档。同时,还需打开自己的思维,使用淘宝Open API编写出有创意的应用。早日上架,早日盈利!

 

posted on 2010-07-06 17:57  riacool  阅读(9701)  评论(0编辑  收藏  举报

导航