Technologie de plate-forme - Instructions d'utilisation du SDK .NET
"Dépendances de l'environnement"
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);
API d'appel par lots
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);
- Adresse du serviceAdresse du service API
Fonctionnalités avancées
Ne pas interpréter la chaîne de réponse comme un objet (à ce stade, l'objet contenu dans XxxResponse est null)
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/");
Utilisez une structure JSON simplifiée pour renvoyer, supprimez les nœuds JSON redondants
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);Annuler la gestion du journal des appels de l'API
DefaultTopClient.SetDisableParser(true)Ignorer la vérification du certificat HTTPS (il est recommandé de l'ouvrir uniquement dans un environnement de test)
DefaultTopClient.SetUseSimplifyJson(true)
Annuler réponse à la fonction de compression GZIP (fonction de compression GZIP Elle peut réduire considérablement la transmission réseau et il est fortement recommandé de ne pas l'annuler)DefaultTopClient.SetDisableTrace(true)
Définissez le délai d'expiration de la connexion HTTP et le délai d'expiration de lecture (peut être augmenté de manière appropriée si l'environnement réseau est médiocre)
DefaultTopClient.SetIgnoreSSLCheck(true)
Modifiez le chemin de stockage des journaux
DefaultTopClient.SetUseGzipEncoding(false)Appel API Réessayez automatiquement lorsque des erreurs se produisent (généralement, les erreurs du FAI peuvent être réessayées avec succès)
// HTTP等待请求开始返回的超时时间:默认20秒 DefaultTopClient.SetTimeout(20000L) // HTTP等待读取数据完成的超时时间:默认60秒 DefaultTopClient.SetReadWriteTimeout(60000L)Routage d'appel API le plus proche (sélectionnez la salle informatique TOP la plus proche à appeler en fonction de l'emplacement où l'API l'appel est effectué)
DefaultTopLogger.FilePath = "c:/tmp/topsdk.log";
Notes
ITopClient Les classes d'implémentation sont toutes thread-safe, il n'est donc pas nécessaire de créer une nouvelle classe d'implémentation ITopClient pour chaque requête API
Lors de la création d'une instance de la classe d'implémentation ITopClient, spécifiez format=json. Par rapport au format XML, il peut réduire la quantité de transmission de données et améliorer l'efficacité des demandes d'API
FAQ