环境

HTTP请求地址

HTTPS请求地址

正式环境

http://gw.api.taobao.com/router/rest

https://eco.taobao.com/router/rest

海外正式环境

http://api.taobao.com/router/rest

https://api.taobao.com/router/rest

环境

服务地址

SSL服务地址

正式环境

ws://mc.api.taobao.com/

无

JAVA 示例：
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);

//找到对应类，比如taobao.trade.fullinfo.get接口对应的请求类为TradeFullinfoGetRequest

TradeFullinfoGetRequest req = new TradeFullinfoGetRequest();

//设置业务参数

req.setFields("tid,type,status,payment,orders,promotion_details");

req.setTid(123456789L);

TradeFullinfoGetResponse rsp = client.execute(req, sessionKey);

System.out.println(rsp.getBody());

PHP 示例：
$c = new TopClient;

$c->appkey = $appkey;

$c->secretKey = $secret;

$req = new TradeFullinfoGetRequest;

$req->setFields("tid,type,status,payment,orders,promotion_details");

$req->setTid("123456789");

$resp = $c->execute($req, $sessionKey);

Python 示例：
# -*- coding: utf-8 -*-

import top.api

req=top.api.TradeFullinfoGetRequest(domain,port)

req.set_app_info(top.appinfo(appkey,secret))

req.fields="tid,type,status,payment,orders,promotion_details"

req.tid=123456789

try:

resp= req.getResponse(sessionkey)

print(resp)

except Exception,e:

print(e)

.NET示例：

ITopClient client = new DefaultTopClient(url, appkey, secret);

TradeFullinfoGetRequest req = new TradeFullinfoGetRequest();

req.Fields = "tid,type,status,payment,orders,promotion_details";

req.Tid = 123456789L;

TradeFullinfoGetResponse rsp = client.Execute(req, sessionKey);

Console.WriteLine(rsp.Body);

C/C++ 示例：
pTopRequest pRequest = alloc_top_request();

pTopResponse pResponse = NULL;

pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);

set_api_name(pRequest,"taobao.trade.fullinfo.get");

add_param(pRequest,"fields","tid,type,status,payment,orders,promotion_details");

add_param(pRequest,"tid","123456789");

pResponse = top_execute(pClient,pRequest,sessionKey);

printf("ret code:%d\n",pResponse->code);

if(pResponse->code == 0){

pTopResponseIterator ite = init_response_iterator(pResponse);

pResultItem pResultItem = alloc_result_item();

while(parseNext(ite, pResultItem) == 0){

printf("%s:%s\n",pResultItem->key,pResultItem->value);

}

destroy_response_iterator(ite);

destroy_result_item(pResultItem);

}

destroy_top_request(pRequest);

destroy_top_response(pResponse);

destroy_taobao_client(pClient);

NodeJS 示例：
TopClient = require('./topClient').TopClient;

var client = new TopClient({

'appkey': 'appkey',

'appsecret': 'secret',

'REST_URL': 'http://gw.api.taobao.com/router/rest'

});

client.execute('taobao.trade.fullinfo.get', {

'fields':'tid,type,status,payment,orders,promotion_details',

'tid':'123456789'

}, function(error, response) {

if (!error) console.log(response);

else console.log(error);

})

JAVA 示例：
TmcClient client = new TmcClient("app_key", "app_secret", "default");

client.setMessageHandler(new MessageHandler() {

public void onMessage(Message message, MessageStatus status) {

try {

System.out.println(message.getContent());

System.out.println(message.getTopic());

} catch (Exception e) {

e.printStackTrace();

status.fail();// 消息处理失败回滚，服务端需要重发

}

}

});

client.connect("ws://mc.api.taobao.com/");

.NET示例：

TmcClient client = new TmcClient("app_key", "app_secret", "default");

client.OnMessage += (s, e) =>

{

try

{

Console.WriteLine(e.Message.Content);

Console.WriteLine(e.Message.Topic);

// 默认不抛出异常则认为消息处理成功

}

catch (Exception exp)

{

Console.WriteLine(exp.StackTrace);

e.Fail(); // 消息处理失败回滚，服务端需要重发

}

};

client.Connect("ws://mc.api.taobao.com/");

功能

JAVA示例

.NET示例

不解释响应字符串为对象

DefaultTaobaoClient.setNeedEnableParser(false)

（这时候XxxResponse包含的对象为null）

DefaultTopClient.SetDisableParser(true)

采用精简化的JSON结构返回，去除多余JSON节点

DefaultTaobaoClient.setUseSimplifyJson(true)

DefaultTopClient.SetUseSimplifyJson(true)

取消API调用日志打点

DefaultTaobaoClient.setNeedEnableLogger(false)

DefaultTopClient.SetDisableTrace(true)

忽略HTTPS证书检查（建议只在测试环境打开）

DefaultTaobaoClient.setIgnoreSSLCheck(true)

DefaultTopClient.SetIgnoreSSLCheck(true)

取消响应GZIP压缩功能（GZIP压缩功能可以显著的减少网络传输，强烈建议不要取消）

DefaultTaobaoClient.setUseGzipEncoding(false)

DefaultTopClient.SetUseGzipEncoding(false)

设置HTTP连接超时和读超时时间（网络环境差的情况下可以适当增大）

// HTTP连接默认超时时间为：3秒

// HTTP响应读默认超时时间为：15秒

DefaultTaobaoClient client = new DefaultTaobaoClient("http://gw.api.taobao.com/router/rest", "appkey", "appsecret", connectTimeout, readTimeout

// HTTP等待请求开始返回的超时时间：默认20秒

DefaultTopClient.SetTimeout(20000L)

// HTTP等待读取数据完成的超时时间：默认60秒

DefaultTopClient.SetReadWriteTimeout(60000L)

API调用出错自动重试（一般情况下ISP类的错误是可以重试成功的）

AutoRetryTaobaoClient client = new AutoRetryTaobaoClient("http://gw.api.taobao.com/router/rest", "appkey", "appsecret");

client.setMaxRetryCount(3);

client.setRetryWaitTime(100L);

TimeGetRequest request = new TimeGetRequest();

TimeGetResponse response = client.execute(request);

if (response.isSuccess()) {

System.out.println(response.getBody());

}

AutoRetryTopClient client = new AutoRetryTopClient("http://gw.api.taobao.com/router/rest", "appkey", "appsecret", "json");

client.SetMaxRetryCount(3);

client.SetRetryWaitTime(100L);

TimeGetRequest request = new TimeGetRequest();

TimeGetResponse response = client.Execute(request);

if (!response.IsError) {

Console.WriteLine(response.Body);

}

API调用就近路由（根据API发起调用所在地选择就近的TOP机房进行调用）

注意：请保持

ClusterTaobaoClient为单例

ClusterTaobaoClient client = new ClusterTaobaoClient("http://gw.api.taobao.com/router/rest", "appkey", "appsecret");

TimeGetRequest request = new TimeGetRequest();

TimeGetResponse response = client.execute(request);

System.out.println(response.getBody());

ClusterTopClient client = new ClusterTopClient("http://gw.api.taobao.com/router/rest", "appkey", "appsecret", "json");

TimeGetRequest request = new TimeGetRequest();

TimeGetResponse response = client.Execute(request);

Console.WriteLine(response.Body);