ledger_data
ledger_data 메서드는 지정된 원장의 내용을 검색합니다. 여러 번의 호출을 반복하여 단일 ledger 버전의 전체 내용을 검색할 수 있습니다.
요청 형식
요청 형식의 예입니다:
Note:
이 메소드에 대한 커맨드라인 구문은 없습니다. 대신 json 메소드를 사용하여 커맨드라인에서 이 메소드에 액세스할 수 있습니다.
요청에는 다음 필드가 포함될 수 있습니다:
| 유형 | 필수 여부 | 설명 |
| 아니요 | 사용할 원장 버전을 식별하는 20바이트 16진수 문자열입니다. | |
| 아니요 | 사용할 원장의 원장 인덱스 또는 자동으로 원장을 선택하는 단축 문자열입니다. (원장 지정 참조) | |
| Boolean | 아니요 |
|
| 숫자 | 아니요 | 검색할 원장 항목 수를 제한합니다. 서버는 이 수보다 적은 수의 항목을 반환할 수 있습니다. 2048(바이너리 요청 시) 또는 256(JSON 요청 시)을 초과할 수 없습니다. 이 범위를 벗어나는 양수 값은 가장 가까운 유효한 옵션으로 대체됩니다. 기본값은 최대값입니다. |
| marker | 아니요 | 이전에 페이지를 매긴 응답의 값입니다. 해당 응답이 중단된 데이터 검색을 재개합니다. |
| Boolean | 아니요 | 특정 유형의 원장 항목으로 결과를 필터링합니다. 유효한 유형은 , |
ledger 필드는 더 이상 사용되지 않으며 별도의 통지 없이 제거될 수 있습니다.
응답 형식
성공적인 응답의 예입니다:
응답은 표준 형식을 따르며, 성공적인 결과에는 다음 필드가 포함됩니다:
| 유형 | 설명 |
| 부호 없는 정수 - 원장 인덱스 | 이 원장 버전의 원장 인덱스입니다. |
| 문자열 - 해시 | 이 원장 버전의 고유 식별 해시입니다. |
| 배열 | 아래 정의된 대로 원장 상태 트리의 데이터를 포함하는 JSON 객체 배열입니다. |
| marker | 응답이 페이지로 매겨졌음을 나타내는 서버 정의 값입니다. 이 통화가 중단된 곳에서 재개하려면 이를 다음 화폐에 전달하세요. |
요청에 유형 필드가 언급된 경우, 배열 객체의 첫 번째 집합이 요청된 유형과 일치하지 않으면 상태 배열이 비어 있습니다. 이러한 경우 이 응답의 마커를 사용하여 페이지네이션을 하고 추가 데이터를 검색할 수 있습니다.
상태 배열의 각 객체 형식은 요청에서 바이너리가 참으로 설정되었는지 여부에 따라 달라집니다. 각 상태 객체에는 다음 필드가 포함될 수 있습니다:
| 유형 | 설명 |
| 문자열 | ( |
| 문자열 | ( |
(추가 필드) | (변수) | ( |
| 문자열 | 이 원장 항목의 고유 식별자(16진수)입니다. |
발생 가능한 오류
모든 범용 오류 유형입니다.
invalidParams - 하나 이상의 필드가 잘못 지정되었거나 하나 이상의 필수 필드가 누락되었습니다.
lgrNotFound - ledger_hash 또는 ledger_index에 지정된 ledger이 존재하지 않거나, 존재하지만 서버에 없습니다.
Last updated