Event监听查询接口
更新时间：2019-09-24
Event监听查询接口
接口描述
本接口提供对已注册Event监听的查询。
权限说明
API权限认证采用Basic Auth方式，请求发起人需要具有合法的Username和Password才能发起请求，其中Username和Password详见所创建的Quorum网络。查看Quorum网络
注意事项
如果请求中没有用户认证信息（即匿名访问），返回401 Unauthorized，错误信息：401 Authorization Required。
服务域名
Quorum合约网关接口服务域名地址<ContractGateWayHost>详见BBE中所创建的Quorum网络详情。查看Quorum网络
请求结构
GET /v2/quorum/event?contract={contract}&subscribeId={subscribeId} HTTP/1.1
Host: <ContractGateWayHost>请求头域
除公共头域外，无其它特殊头域。
请求参数
| 名称 | 类型 | 位置 | 描述 | 是否必须 |
|---|---|---|---|---|
| subscribeId | String | Query参数 | 事件监听ID | 选填 |
| contract | String | Query参数 | 事件所在合约地址 | 选填 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| requestId | String | 用户请求携带的X-Request-Id |
| result | JsonObject | 事件监听注册查询结果 |
| count | Integer | 事件监听注册个数 |
| subscribeList | Array | 事件监听注册列表 |
| subscribeId | String | 事件监听注册ID |
| contract | String | 事件所在合约地址 |
| subscribeUrl | String | 用户接收事件数据URL |
| invokeDescription | InvokeDescription | 事件监听描述 |
| name | String | 事件名称 |
| params | Array | 事件监听过滤条件 |
| subscribeTime | String | 事件监听注册时间 |
请求示例
说明：可根据事件订阅ID和事件所在合约地址进行检索过滤，如下方请求示例中，使用合约地址所以查询条件。
GET /v2/quorum/event?contract=0x5c695f5b6c14d4d59b1b2f65a7fb66f02fe15469 HTTP/1.1
Host: 106.12.189.XXX:8080请求响应示例
HTTP/1.1 200 OK
Date: Thu, 19 Sep 2019 10:47:41 GMT
Content Type: application/json; charset=utf-8
Content-Length: 562
{
"requestId": "2825fcac-55c5-4eb1-8be6-758185ba523a",
"result": {
"count": 1,
"subscribeList": [
{
"subscribeId": "7a739a8e-dd26-48df-9119-1fa9ca19f71d",
"contract": "0x5C695f5b6c14D4D59b1B2F65A7fB66f02fe15469",
"subscribeUrl": "http:/XXX",
"invokeDescription": {
"name": "ChangeEvent",
"params": {
"i": [
111,
222
]
}
},
"subscribeTime": "2019-09-19T10:46:35.177469455Z"
}
]
}
}