wsTCP 及 HTTP API《开发文档》及相关文件说明

微盛投资

【API接口使用授权说明】：本API接口提供的相应行情及数据仅供甲方（用户）内部研究使用。且甲方（用户）应在国家法律条款的范围内使用。
【重要提醒】：行情可能中断，数据可能错误，我方对行情品质、数据品质不作任何承诺。用户使用、购买前请慎重。

20170609升级：微盛推送式API接口已升级支持直接返回txt 方式，开发对接会更方便。详细说明请点击此处

一、开发建议：

1、开发初期，我方建议，可分为两个程序，一个程序只负责接收，收到之后的原始报文不作任何处理，直接存储到二进制文件中，为避免文件过大，该文件可按日期命名，例如 WS20150115.wsz

2、另外一个程序，则只负责从这个文件中不断读取数据，并解压、转码、入库等相应工作。

3、以上方式，相应逻辑关系清晰，便于编码，可有利于提升程序的可靠性、稳定性。出现解压失败等情况时也便于查询原因，且对性能的影响不足10毫秒（0.01秒）。

4、两个程序的方式运行一段时间且稳定可靠后，如觉得有必要，可再更改为在一个程序中多线程接收及异步处理的方式（附件demo源码为在一个程序中异步处理）。

5、我方推荐采用两个程序的方式，从多个客户实际运行效果来看，这种方式大大提升了整体接收系统的可靠性、稳定性，且降低了开发难度。

6、socket本身是动态的，切勿直接采用类似 socket.readInt(); 等方法，这样直接从socket中读取数据是错误的。只能是从socket中读入一个缓存（字节数组），且必须判断实际读取得到的长度，例如： buffer=new byte[10240]; size=socket.read(buffer); if (size>0) { ; //buffer中前面 size字节才是实际从 socket 中读取到的数据}。

二、文件说明：

1、《开发文档》，demo源码等相应文件的下载链接：http://pan.baidu.com/s/1ntByBgP(下载链接密码，在发送给您的邮件中；如提示链接不存在，重试一次即可)
进入文件夹后，请点击文件名，这样可按文件名排序，更方便阅读。
其中有一个文件夹，命名为：中文文件名，该文件夹中为中文命名的文件，会更直观一些。

说明：免费试用的测试行情，与正式行情完全相同，只是有时间限制，例如部分市场仅奇数（偶数）小时可用。
免费试用测试行情具体时间限制请见如下链接： http://test.wstock.cn/markets_time.htm

2、wsRT_API_TCP_v20151008.rar：这个文件中是详细的开发说明文档；

3、wsSample.rar：开发前期，可先参考该rar中的 wsSample_Readme.txt，对该rar中的wsSample.wsz进行解压，这样可快速熟悉数据结构；

4、wsRTSCK_CS_Demo_20140915.rar.aaa：这是c#的demo 源码（含接收、解压、转码的全过程，如没有 C# 的开发环境，可直接将 Form1.cs 作为文本文件打开阅读），请将其中的[username]、[password]替换为贵方的用户名、密码（实际用户名、密码中不需要前后的方括号），m=市场替换为贵方购买的市场（例如 m=WA）。即可实际接收到相应的实时行情数据，接收到的行情数据转化为txt文件存储在对应的bin\Debug\wsLog.txt文件中，接收到的二进制原始文件存储在您在程序界面中指定的文件中。备注：周末或休市期间无行情。

5、VC2010_Demo.rar.aaa 与 wsDemoCode_VC6_20150715.rar.aaa ：这是两份 VC的Demo源码，前者演示了利用VC如何对数据进行解压缩；后者演示了如何通过VC接收行情。

6、wsz2dat_cs.rar.aaa：这是c#的demo源码，演示了利用c#如何对数据进行解压缩；

7、wsz2dat_pl.rar.aaa：这是perl的demo源码，演示了在perl中如何对数据解压缩（linux下可用；Windows平台中如安装了perl，则也可使用）；

8、zlib.NET_source_104.zip.aaa：这个是基于.net的解压缩底层dll部件的源码（zlib是开源的），仅供参考（程序中实际只用到dll本身）。

9、wsSymbols_HI_WG_WA.rar：HI、WG、WA市场的代码表，请参阅。

10、wsTCP_Samples.rar：一个TCP SOCKET实际接收到的原始文件样本，以及相应说明，可参考。

11、java_WSZUnpackTool.rar：我方客户提供的java版解压缩程序，含源码。

附： tcp版 c# demo程序示意图

附： http版 c# demo程序示意图

微盛投资

www.wstock.net

2015.10.08