【软件工程应用与实际】(3)JDchain对事件查询及监听

2021SC@SDUSC

1 事件相关信息的获取

1.1 获取事件账户列表

GET /ledgers/{ledger}/events/user/accounts?fromIndex={fromIndex}&count={count}

参数

请求类型	名称	是否必需	说明	数据类型
path	ledger	是	账本哈希	字符串
query	fromIndex	否	查询的起始序号，默认为0	数字
query	count	否	查询返回事件账户的数量，默认最大返回值为100，小于0或大于100均返回最大可返回结果集	数字

1.2 获取事件账户

GET /ledgers/{ledger}/events/user/accounts/{address}

参数

请求类型	名称	是否必需	说明	数据类型
path	ledger	是	账本哈希	字符串
address	账户地址	是	事件账户地址	字符串

1.3 获取事件账户总数

GET /ledgers/{ledger}/events/user/accounts/count

参数

请求类型	名称	是否必需	说明	数据类型
path	ledger	是	账本哈希	字符串

1.4 获取事件名数量

GET /ledgers/{ledger}/events/user/accounts/{address}/names/count

参数

请求类型	名称	是否必需	说明	数据类型
path	ledger	是	账本哈希	字符串
path	address	是	事件账户地址	字符串

1.5 获取事件名列表

GET /ledgers/{ledger}/events/user/accounts/{address}/names?fromIndex={fromIndex}&count={count}

参数

请求类型	名称	是否必需	说明	数据类型
path	ledger	是	账本哈希	字符串
path	address	是	事件账户地址	字符串
query	fromIndex	否	查询的起始序号，默认为0	数字
query	count	否	查询返回事件账户的数量，默认最大返回值为100，小于0或大于100均返回最大可返回结果集	数字

1.6 获取最新事件

GET /ledgers/{ledger}/events/user/accounts/{address}/names/{event_name}/latest

参数

请求类型	名称	是否必需	说明	数据类型
path	ledger	是	账本哈希	字符串
path	address	是	事件账户地址	字符串
path	event_name	是	事件名	字符串

1.7 获取事件数量