调用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

记录类型。取值如下:

  • CUSTOM:用户自定义操作。
  • CREATE_LEDGER:创建账本。
  • DELETE_LEDGER:删除账本。
  • UPDATE_LEDGER:更新账本。
  • CREATE_MEMBER:创建成员。
  • DELETE_MEMBER:删除成员操作。
  • UPDATE_MEMBER_KEY:更新成员公钥。
  • UPDATE_MEMBER_PERMISSIONS:更新成员密钥。
  • ENABLE_MEMBER:恢复成员。
  • DISABLE_MEMBER:禁用成员。
  • SET_TRUST_POINT:设置信任锚点。
  • CREATE_TIMEANCHOR:创建时间锚点。
  • KV_SET:Set一个KEY。
  • KV_DELETE:Delete一个KEY。
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 无操作权限

访问错误中心查看更多错误码。

访问错误中心查看更多错误码。