Kebergantungan alam sekitar

• .NET Framework 2.0 dan ke atas (platform Windows Phone tidak disokong)

Contoh penggunaan

Dapatkan masa sistem semasa Taobao

rreee

Dapatkan perincian mesej transaksi tunggal

ITopClient client = new DefaultTopClient("http://gw.api.taobao.com/router/rest", "appkey", "appsecret", "json");
TimeGetRequest req = new TimeGetRequest();
TimeGetResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

Batch call API

ITopClient client = new DefaultTopClient("http://gw.api.taobao.com/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);

Alamat perkhidmatan

Alamat perkhidmatan API

Alamat perkhidmatan mesej

Ciri lanjutan

Ciri lanjutan

terkandung dalam objek ini XxxResponse adalah batal)

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/");

Gunakan struktur JSON yang dipermudahkan untuk kembali, alih keluar nod JSON yang berlebihan

BatchTopClient client = new BatchTopClient("http://gw.api.taobao.com/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);

Batalkan pengurusan log panggilan API

DefaultTopClient.SetDisableParser(true)

Abaikan semakan sijil HTTPS (disyorkan untuk dibuka dalam persekitaran ujian sahaja)

rrCcelee tindak balas kepada fungsi mampatan GZIP (Fungsi mampatan GZIP Ia boleh mengurangkan penghantaran rangkaian dengan ketara, dan amat disyorkan untuk tidak membatalkan)

DefaultTopClient.SetUseSimplifyJson(true)

Tetapkan tamat masa sambungan HTTP dan tamat masa baca (boleh ditingkatkan dengan sewajarnya jika persekitaran rangkaian lemah)

DefaultTopClient.SetDisableTrace(true)

Ubah suai laluan storan log

DefaultTopClient.SetIgnoreSSLCheck(true)

Panggilan API Cuba semula secara automatik apabila ralat berlaku (biasanya ralat ISP boleh dicuba semula dengan jayanya)

DefaultTopClient.SetUseGzipEncoding(false)

API panggilan penghalaan terdekat (pilih bilik komputer TOP terdekat untuk membuat panggilan berdasarkan lokasi API panggilan dibuat)

// HTTP等待请求开始返回的超时时间：默认20秒
DefaultTopClient.SetTimeout(20000L)
// HTTP等待读取数据完成的超时时间：默认60秒
DefaultTopClient.SetReadWriteTimeout(60000L)

Nota

• ITopClient Kelas pelaksanaan semuanya selamat untuk thread, jadi tidak perlu mencipta kelas pelaksanaan ITopClient baharu untuk setiap permintaan API
• Apabila membuat contoh kelas pelaksanaan ITopClient, nyatakan format=json. Berbanding dengan format xml, ia boleh mengurangkan jumlah penghantaran data dan meningkatkan kecekapan Permintaan API

FAQ

• Belum ada FAQ tentang dokumen ini