Call the ListTimeAnchors to get the anchor list of the ledger.
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Required | ListTimeAnchors |
The operation that you want to perform. Valid values: ListTimeAnchors |
LedgerId | String | Required | l-c8cc7be3eea542axxxxxxxxxx |
The ID of the ledger instance. |
Reverse | Boolean | No | false |
The iteration direction. The default value is false, in which the creation time of a time anchor point is modified from the old to the new. If this parameter is set to true, the new anchor is updated to the original iteration based on the creation time. |
NextToken | String | No | xxx |
Used to mark the current start reading position. If you set the parameter to Null, you must start reading data from the beginning. |
MaxResults | Integer | Optional | 100 |
The maximum amount of data to read. Default value: 10. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
MaxResults | Integer | 100 |
The maximum amount of data to read. |
NextToken | String | xxxx |
Returns the position where the data is read. Empty indicates that the data has been read. |
RequestId | String | 89E6B5F5-7511-46A7-9EDB-3C6F8AA4D48C |
The request ID. |
TimeAnchors | Array |
The list of time anchors. |
|
JournalId | Long | 57 |
The ID of the record. |
LedgerDigest | String | 04d45eb3bcbd2a47aeb5de87b73fd6a324bb7b57a081fd474a82d8dc7e830d42868aeb15a9fa02ac09205b68ecfc78e8e67c70c67736aa0e867a9a7011b83fab4b |
Ledger summary. |
LedgerDigestType | String | SHA256 |
Ledger summary type. |
LedgerVersion | Long | 57 |
The version of the ledger. |
Proof | String | {"hashInHex":"de6eb06dfbbe534eedfdad435698d340f0dcba91b8bd4b76758317b00562daf6","sequence":49998} |
Time evidence. |
TimeStamp | Long | 1587515659 |
The timestamp when the value was obtained. Unit: second. |
Examples
Sample requests
http(s)://[Endpoint]/? Action=ListTimeAnchors
&LedgerId=l-c8cc7be3eea542axxxxxxxxxx
&<Common request parameters>
Sample success responses
XML
format
<TimeAnchors>
<LedgerDigest>04d45eb3bcbd2a47aeb5de87b73fd6a324bb7b57a081fd474a82d8dc7e830d42868aeb15a9fa02ac09205b68ecfc78e8e67c70c67736aa0e867a9a7011b83fab4b</LedgerDigest>
<JournalId>57</JournalId>
<LedgerDigestType>SHA256</LedgerDigestType>
<Proof>{"hashInHex":"de6eb06dfbbe534eedfdad435698d340f0dcba91b8bd4b76758317b00562daf6","sequence":49998}</Proof>
<LedgerVersion>57</LedgerVersion>
<TimeStamp>1587515659</TimeStamp>
</TimeAnchors>
<RequestId>89E6B5F5-7511-46A7-9EDB-3C6F8AA4D48C</RequestId>
<NextToken>xxxx</NextToken>
<MaxResults>100</MaxResults>
JSON
format
{
"TimeAnchors": {
"LedgerDigest": "04d45eb3bcbd2a47aeb5de87b73fd6a324bb7b57a081fd474a82d8dc7e830d42868aeb15a9fa02ac09205b68ecfc78e8e67c70c67736aa0e867a9a7011b83fab4b",
"JournalId": 57,
"LedgerDigestType": "SHA256",
"Proof": "{\"hashInHex\":\"de6eb06dfbbe534eedfdad435698d340f0dcba91b8bd4b76758317b00562daf6\",\"sequence\":49998}",
"LedgerVersion": 57,
"TimeStamp": 1587515659
},
"RequestId": "89E6B5F5-7511-46A7-9EDB-3C6F8AA4D48C",
"NextToken": "xxxx",
"MaxResults": 100
}
Error codes
HttpCode | Error code | Error message | Description |
---|---|---|---|
400 | InvalidParameter | The specified parameter %s is invalid. | The error message returned because the specified parameters are invalid. |
400 | MissingParameter | You must specify the parameter %s. | The error message returned when the client token is not specified. |
404 | ResourceNotFound | The specified resource %s does not exist. | Resource not found |
403 | UnauthorizedOperation | You are not authorized to perform this operation. %s | No operation permissions |
For a list of error codes, visit the API Error Center.