Event监听查询接口
更新时间：2019-09-19
Event监听查询接口
接口描述
本接口提供对已注册Event监听的查询。
权限说明
API权限认证采用Basic Auth方式，请求发起人需要具有合法的Username和Password才能发起请求，其中Username和Password详见所创建的以太坊网络。查看以太坊网络
注意事项
如果请求中没有用户认证信息（即匿名访问），返回401 Unauthorized，错误信息：401 Authorization Required。
服务域名
以太坊合约网关接口服务域名地址<ContractGateWayHost>详见BBE中所创建的以太坊网络详情。查看以太坊网络
请求结构
Plain Text
1GET /v2/ethereum/event?contract={contract}&subscribeId={subscribeId} HTTP/1.1
2 Host: <ContractGateWayHost>请求头域
除公共头域外，无其它特殊头域。
请求参数
| 名称 | 类型 | 位置 | 描述 | 是否必须 |
|---|---|---|---|---|
| subscribeId | String | Query参数 | 事件监听ID | 选填 |
| contract | String | Query参数 | 事件所在合约地址 | 选填 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| requestId | String | 用户请求Id |
| result | JsonObject | 事件监听注册查询结果 |
| count | Integer | 事件监听注册个数 |
| subscribeList | Array | 事件监听注册列表 |
| subscribeId | String | 事件监听注册ID |
| contract | String | 事件所在合约地址 |
| subscribeUrl | String | 用户接收事件数据URL |
| invokeDescription | InvokeDescription | 事件订阅描述 |
| name | String | 事件名称 |
| params | Array | 事件监听过滤条件 |
| subscribeTime | String | 事件监听注册时间 |
请求示例
说明：可根据事件订阅ID和事件所在合约地址进行检索过滤，如下方请求示例中，使用合约地址所以查询条件。
Plain Text
1 GET /v2/ethereum/event?contract=0x134BFd7a3D43ca3b4599718045156ADa22EC8591 HTTP/1.1
2 Host: 106.12.189.XXX:8080请求响应示例
Plain Text
1HTTP/1.1 200 OK
2 Date: Thu, 19 Sep 2019 07:38:37 GMT
3 Content Type: application/json; charset=utf-8
4 Content-Length: 1029
5{
6 "requestId": "a34272bb-652c-4d29-97e6-1a412fc12493",
7 "result": {
8 "count": 2,
9 "subscribeList": [
10 {
11 "subscribeId": "fbd08f7f-2ee7-46d1-b210-cb2ede56030e",
12 "contract": "0x134BFd7a3D43ca3b4599718045156ADa22EC8591",
13 "subscribeUrl": "http://XXX",
14 "invokeDescription": {
15 "name": "ChangeEvent",
16 "params": {
17 "i": [
18 111,
19 222
20 ]
21 }
22 },
23 "subscribeTime": "2019-09-19T07:23:55.435083031Z"
24 },
25 {
26 "subscribeId": "6cb77e8d-b21b-4d5d-a446-b858af5b26af",
27 "contract": "0x134BFd7a3D43ca3b4599718045156ADa22EC8591",
28 "subscribeUrl": "http://XXX",
29 "invokeDescription": {
30 "name": "ChangeEvent",
31 "params": {
32 "from": [
33 "0x7244ea287849942baac280b1912a575aeeccc792"
34 ]
35 }
36 },
37 "subscribeTime": "2019-09-19T07:38:34.777865918Z"
38 }
39 ]
40 }
41}