淘宝.NET SDK使用说明.doc

环境依赖 .NET Framework 2.0 及以上 （不支持Windows Phone平台）使用示例获取淘宝当前系统时间1234ITopClient client = new DefaultTopClient(/router/rest, appkey, appsecret, json);TimeGetRequest req = new TimeGetRequest();TimeGetResponse rsp = client.Execute(req);Console.WriteLine(rsp.Body);获取单笔交易详情123456ITopClient client = new DefaultTopClient(/router/rest, appkey, appsecret, json);TradeFullinfoGetRequest req = new TradeFullinfoGetRequest();req.Fields = tid,type,status,payment,orders;req.Tid = 123456789L;TradeFullinfoGetResponse rsp = client.Execute(req, sessionKey);Console.WriteLine(rsp.Body);监听实时消息通知12345678910111213141516TmcClient 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://);批量调用API1234567BatchTopClient client = new BatchTopClient(/router/batch, appkey, appsecret, json);TimeGetRequest timeRequest = new TimeGetRequest();AppipGetRequest ipRequest = new AppipGetRequest();TopBatchRequest batch = new TopBatchRequest();batch.AddRequest(timeRequest).AddRequest(ipRequest);TopBatchResponse rsp = client.Execute(batch);Console.WriteLine(rsp.Body);服务地址API服务地址环境HTTP请求地址HTTPS请求地址正式环境/router/rest/router/rest海外正式环境/router/rest/router/rest沙箱环境/router/rest/router/rest消息服务地址环境服务地址SSL服务地址正式环境ws://无沙箱环境ws://无高级功能不解释响应字符串为对象（这时候XxxResponse包含的对象为null）1DefaultTopClient.SetDisableParser(true)采用精简化的JSON结构返回，去除多余JSON节点1DefaultTopClient.SetUseSimplifyJson(true)取消API调用日志打点1DefaultTopClient.SetDisableTrace(true)忽略HTTPS证书检查（建议只在测试环境打开）1DefaultTopClient.SetIgnoreSSLCheck(true)取消响应GZIP压缩功能（GZIP压缩功能可以显著的减少网络传输，强烈建议不要取消）1DefaultTopClient.SetUseGzipEncoding(false)设置HTTP连接超时和读超时时间（网络环境差的情况下可以适当增大）1234/ HTTP等待请求开始返回的超时时间：默认20秒DefaultTopClient.SetTimeout(20000L)/ HTTP等待读取数据完成的超时时间：默认60秒DefaultTopClient.SetReadWriteTimeout(60000L)修改日志打点存储路径1DefaultTopLogger.FilePath = c:/tmp/topsdk.log;API调用出错自动重试（一般情况下ISP类的错误是可以重试成功的）12345678AutoRetryTopClient client = new AutoRetryTopClient(/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机房进行调用）1234ClusterTopClient client = new ClusterTopClient(/router/rest, appkey, appsecret, json);TimeGetRequest request = new TimeGetRequest();TimeGetResponse response = client.Execute(request);Con