环境依赖
使用示例
获取当前系统时间
DefaultTaobaoClient client = new DefaultTaobaoClient("http://gw.api.taobao.com/router/rest", "appkey", "appsecret");
TimeGetRequest request = new TimeGetRequest();
TimeGetResponse response = client.execute(request);
if (response.isSuccess()) {
System.out.println(response.getBody());
}
获取线上发货物流订单信息
String url = new String("http://gw.api.taobao.com/router/rest");
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AliexpressLogisticsRedefiningGetonlinelogisticsinfoRequest req = new AliexpressLogisticsRedefiningGetonlinelogisticsinfoRequest();
req.setChinaLogisticsId("LA234234CN");
req.setInternationalLogisticsId("LP00038357949881");
req.setLogisticsStatus("CLOSED");
req.setGmtCreateEndStr("2016-06-27 18:15:00");
req.setPageSize(10L);
req.setQueryExpressOrder(false);
req.setCurrentPage(1L);
req.setOrderId(60015640573917L);
req.setGmtCreateStartStr("2016-06-27 18:20:00");
AliexpressLogisticsRedefiningGetonlinelogisticsinfoResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());
服务地址
API服务地址
环境 |
HTTP请求地址 |
HTTPS请求地址 |
正式环境 |
||
海外正式环境 |
高级功能
不解释响应字符串为对象(这时候XxxResponse包含的对象为null)
DefaultTaobaoClient.setNeedEnableParser(false)
采用精简化的JSON结构返回,去除多余JSON节点
DefaultTaobaoClient.setUseSimplifyJson(true)
取消API调用日志打点
DefaultTaobaoClient.setNeedEnableLogger(false)
忽略HTTPS证书检查(建议只在测试环境打开)
DefaultTaobaoClient.setIgnoreSSLCheck(true)
取消响应GZIP压缩功能(GZIP压缩功能可以显著的减少网络传输,强烈建议不要取消)
DefaultTaobaoClient.setUseGzipEncoding(false)
设置HTTP连接超时和读超时时间(网络环境差的情况下可以适当增大)
// HTTP连接默认超时时间为:3秒
// HTTP响应读默认超时时间为:15秒
DefaultTaobaoClient client = new DefaultTaobaoClient("http://gw.api.taobao.com/router/rest", "appkey", "appsecret", connectTimeout, readTimeout)
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());
}
API调用就近路由(根据API发起调用所在地选择就近的TOP机房进行调用)
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());
注意事项