调用ListJournals获取账本中记录列表。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListJournals |
系统规定参数。取值:ListJournals。 |
LedgerId | String | 是 | l-c8cc7be3eea542axxxxxxxxxx |
账本ID。 |
Clue | String | 否 | clue1 |
线索ID。 |
MemberId | String | 否 | m-04389ec1075443bcxxxxxxxxxx |
成员ID。 |
NextToken | String | 否 | xxxx |
用来标记当前开始读取的位置。置空表示从头开始。 |
MaxResults | Integer | 否 | 100 |
本次读取的最大数据量,默认值为1024。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Journals | Array |
记录列表。 |
|
ClientId | String | xxxx |
写入记录的客户端ID。 |
Clues | List | clue1 |
记录的线索ID列表。 |
JournalHash | String | 04d45eb3bcbd2a47aeb5de87b73fd6a324bb7b57a081fd474a82d8dc7e830d42868aeb15a9fa02ac09205b68ecfc78e8e67c70c67736aa0e867a9a7011b83fab4b |
记录hash。 |
JournalId | String | 100 |
记录ID。 |
LedgerId | String | l-c8cc7be3eea542axxxxxxxxxx |
账本实例ID。 |
MemberId | String | m-04389ec1075443bcxxxxxxxxxx |
写入记录的成员ID。 |
PayloadJsonString | String | xxxxxxxxxxxxxxxxxxxxx |
记录数据。 |
PayloadType | String | CUSTOM |
记录类型。取值如下:
|
Timestamp | Long | 1587090122155 |
写入记录的时间。单位为毫秒。 |
MaxResults | Integer | 100 |
本次读取的最大数据量。 |
NextToken | String | xxxx |
用来表示当前调用返回读取到的位置。空代表数据已经读取完毕。 |
RequestId | String | 89E6B5F5-7511-46A7-9EDB-3C6F8AA4D48C |
请求ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=ListJournals
&LedgerId=l-c8cc7be3eea542axxxxxxxxxx
&<公共请求参数>
正常返回示例
XML
格式
<RequestId>89E6B5F5-7511-46A7-9EDB-3C6F8AA4D48C</RequestId>
<NextToken>xxxx</NextToken>
<MaxResults>100</MaxResults>
<Journals>
<MemberId>m-04389ec1075443bcxxxxxxxxxx</MemberId>
<JournalId>100</JournalId>
<ClientId>xxxx</ClientId>
<LedgerId>l-c8cc7be3eea542axxxxxxxxxx</LedgerId>
<JournalHash>04d45eb3bcbd2a47aeb5de87b73fd6a324bb7b57a081fd474a82d8dc7e830d42868aeb15a9fa02ac09205b68ecfc78e8e67c70c67736aa0e867a9a7011b83fab4b</JournalHash>
<Timestamp>1587090122155</Timestamp>
<PayloadType>CUSTOM_PAYLOAD</PayloadType>
<PayloadJsonString>xxxxxxxxxxxxxxxxxxxxx</PayloadJsonString>
</Journals>
<Journals>
<Clues>clue1</Clues>
</Journals>
JSON
格式
{
"RequestId": "89E6B5F5-7511-46A7-9EDB-3C6F8AA4D48C",
"NextToken": "xxxx",
"MaxResults": 100,
"Journals": [
{
"MemberId": "m-04389ec1075443bcxxxxxxxxxx",
"JournalId": 100,
"ClientId": "xxxx",
"LedgerId": "l-c8cc7be3eea542axxxxxxxxxx",
"JournalHash": "04d45eb3bcbd2a47aeb5de87b73fd6a324bb7b57a081fd474a82d8dc7e830d42868aeb15a9fa02ac09205b68ecfc78e8e67c70c67736aa0e867a9a7011b83fab4b",
"Timestamp": 1587090122155,
"PayloadType": "CUSTOM_PAYLOAD",
"PayloadJsonString": "xxxxxxxxxxxxxxxxxxxxx"
},
{
"Clues": "clue1"
}
]
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidParameter | The specified parameter %s is invalid. | 参数无效 |
400 | MissingParameter | You must specify the parameter %s. | 参数缺失 |
404 | ResourceNotFound | The specified resource %s does not exist. | 资源不存在 |
403 | UnauthorizedOperation | You are not authorized to perform this operation. %s | 无操作权限 |
访问错误中心查看更多错误码。
访问错误中心查看更多错误码。