井通区块链Api订阅服务介绍

本节介绍井通区块链标准接口的订阅服务功能。

为了减少前端软件的复杂度，井通区块链标准接口(REST API)提供了井通钱包地址的websocket长连接服务。前端软件可以通过 websocket连接向标准接口订阅和井通地址相关的交易信息。一旦订阅成功，任何和该地址相关的交易信息将会通过相应的 websocket连接传给订阅客户端。

REST API订阅后台服务器的测试环境是: wss://tapi.jingtum.com:5443/v2 。

由于订阅功能是采用websocket实现的，因此要测试订阅功能，可以采用websocket在线测试工具。 这里推荐一款比较好用的websocket在线测试工具: http://ws.douqq.com/ 。 另外，由于websocket返回的都是JSON格式的数据，比较难以阅读，可以采用JSON在线解析工具。 这里推荐一款好用的JSON在线解析工具: https://www.bejson.com/ 。

例子:

1)在浏览器里面打开 http://ws.douqq.com/ 网站。

2)在ws链接输入框里面输入 wss://tapi.jingtum.com:5443/v2 ，点击后面的“连接”按钮。 3)如果不出意外，就会连接上订阅服务器。如下如所示:

如果写程序调用，连接订阅服务器后，就可以实现自动化处理订阅请求的返回消息。

1)客户端连接上订阅服务器后，就可以向服务器发起订阅请求。订阅请求格式如下:

订阅请求中，必须将订阅用户的钱包地址和订阅类型一起提交上来。 参数type表示订阅类型，包含3种: account:订阅某个账号的交易记录、 transactions:订阅所有交易记录、

ledger:订阅账本消息

订阅成功之后，返回:

一旦订阅成功，这个订阅状态就会一直持续，直到客户端取消订阅，或者关闭订阅。如果由于网络原因，导致订阅失效，也 需要重新订阅。

当请求的JSON格式不对时，返回:

当请求的参数有问题时，返回:

error包括缺少account，type，account格式不对，type格式不对等，分别是: 1.missing account 2.account is not valid jingtum address

3.invalid type，......

客户端订阅了钱包的交易消息，然后向该钱包发送支付交易，客户端可以收到如下的交易信息:

基本格式为:

account: 帐号，订阅的井通钱包地址。

type: 交易类型，与API里面的信息一致，主要有Payment、OfferCreate、OfferCancel和RelationSet transaction: 交易信息，与API里面的信息一致。

在用户被动成交时，用户也会收到交易相关的信息。

当交易失败时，会有如下的格式的消息:

通过success可以判断返回的交易结果是成功的还是失败的，其他的失败记录均即时反馈回给用户，无需在订阅中获得。

取消订阅成功时候，返回:

当请求的JSON格式有问题时，返回:

当请求的参数不正确时，返回:

取消订阅，参数不正确主要是account缺失或者格式不正确: a)account is missing b)Invalid type 等

首先启动“SSR(短SSR(shadowsockr)”软件。2.然后，右键点击紫色小平面，找到服务器订阅-SSR服务器订阅设置。3.点击“添加”按钮，输入SSR订阅地址，然后点击确定(订阅地址在后面)，这样就可以多行使用了。4.然后再次返回“服务器订阅”并单击“更新SSR服务器订阅(无代理)”。当然，如果没有代理无法更新订阅，可以尝试第二种。当出现此提示时，表示服务器线路订阅成功(电脑订阅不成功，记得将代理模式改为直连模式，然后更新订阅)。5.再次返回服务器列表的时候，已经可以看到有很多行可以选择了，这个时候就选一个吧！选定一条路由后，我们再设置一些小细节:代理规则——绕过局域网和大陆(访问局域网和大陆不会经过代理节点)6。然后系统代理模式:换成PAC(如果需要的话)，有的网站需要全局代理。连接后百度输入IP，看IP地址，已经可以看到切换到香港IP，此时可以使用。

基本上现在都在正常使用，不知道你是不是在安装新版本。

1）正常创建虚拟机，size选b1s，镜像选择上windows的搜索smalldisk，对于b1s实例建议选择windows server 2012 r2的。

2）创建好虚拟机后，点虚拟机进去，顶部有几个操作按钮，点击停止。

3）停止后，点击左边菜单的disks，进入磁盘页面，点击os disk下面的那个磁盘连接。

4）进入后，点击configuration，将大小改为64，点击保存。

5）完成后回到虚拟机页面，点击start，启动虚拟机即可完成系统盘改为免费64G磁盘的目的

订阅配额里面有2项关于b1s虚拟机配额的使用情况，如果你同时创建了一个b1s大小的linux虚拟机和一个b1s大小windows虚拟机，你可能会发现配额四种情况这里，B1s - BS Series一直增加，而且好像还超标了，像是2个b1s实例都算到这个上了，而另一个B1s - BS Series Windows却一直是0，始终未使用到。

这个问题是由于一个我们习惯性的操作引起的，azure上对于windows实例是要加收钱的，但他有一个选项，就是可以使用你现有的windows许可抵消，使用的方法也很简单，只要勾选一个选项就可以了。所以我们创建windows主机的时候为了省钱一般都会勾选这个选项。问题就在这里，为了能够使用到免费的b1s的windows实例，你创建虚拟机的时候不要去选这个，这样创建出来的windows虚拟机就会计算到B1s - BS Series Windows上。

隔一段时间看看，如果连个b1s和p6磁盘的配额用上了，就说明免费配额你完全使用上了。

至此，你就可以充分使用azure学生订阅提供的免费配额，一个linux跑点服务，一个windows挂机，很方便，以香港区的价格计算，光这两个完全免费的虚拟机每年的价值就两三百刀。

---