account_lines
account_lines 메소드는 계정의 신뢰선에 대한 정보를 반환하며, 여기에는 XRP가 아닌 모든 통화와 자산의 잔액이 포함되어 있습니다. 검색된 모든 정보는 특정 버전의 ledger을 기준으로 합니다.
요청 형식
요청 형식의 예시입니다:
이 요청은 다음 매개변수를 허용합니다:
| 유형 | 설명 |
| 문자열 - 주소 | 이 계좌에 연결된 신뢰선을 찾아보세요. |
| 문자열 | (선택 사항) 사용할 원장 버전에 대한 20바이트 16진수 문자열입니다. (원장 지정 참조) |
| 숫자 또는 문자열 | (선택) 사용할 원장의 원장 인덱스 또는 자동으로 원장을 선택하는 단축 문자열입니다. (원장 지정 참조) |
| 문자열 - 주소 | (선택사항) 두 번째 계정 제공된 경우 두 계정을 연결하는 신뢰선으로 결과를 필터링합니다. |
| 숫자 | (선택 사항) 검색할 신뢰선 수를 제한합니다. 결과 페이지가 더 많더라도 서버는 지정된 제한보다 적은 양을 반환할 수 있습니다. 10~400 범위 내에 있어야 합니다. 기본값은 200입니다. |
| marker | (선택 사항) 페이지를 매긴 이전 응답의 값입니다. 해당 응답이 중단된 데이터 검색을 재개합니다. |
다음 매개변수는 더 이상 사용되지 않으며 추후 공지 없이 제거될 수 있습니다: ledger 및 peer_index.
응답 형식
성공적인 응답의 예입니다:
응답은 표준 형식을 따르며, 성공적인 결과에는 계정 주소와 신뢰줄 객체 배열이 포함됩니다. 구체적으로 결과 객체에는 다음 필드가 포함됩니다:
| 유형 | 설명 |
| 문자열 | 이 요청에 해당하는 계정의 고유 주소입니다. 이는 신뢰선의 목적을 위한 "관점 계정"입니다. |
| 배열 | 아래에 설명된 대로 신뢰 라인 객체의 배열입니다. 신뢰 라인 수가 많은 경우 limit한 번에 최대 라인만 반환합니다. |
| 정수 - 원장 색인 | |
| 정수 - 원장 색인 | |
| 문자열 - 해시 | |
| marker |
각 신뢰 객체에는 다음 필드의 일부 조합이 있습니다:
| 유형 | 설명 |
| 문자열 | 이 신뢰선에 대한 상대방의 고유 주소입니다. |
| 문자열 | 이 라인에 대해 현재 보유하고 있는 숫자 잔액을 나타냅니다. 양수 잔액은 관점 계정에 가치가 있음을 의미합니다. 마이너스 잔액은 관점 계정에 가치가 있다는 것을 의미합니다. |
| 문자열 | 이 신뢰선이 보유할 수 있는 통화를 식별하는 통화 코드 입니다. |
| 문자열 | 이 계정이 동료 계정에 지불할 의사가 있는 특정 통화의 최대 금액입니다. |
| 문자열 | 상대방 계정이 관점 계정에 지불할 의사가 있는 최대 통화 금액입니다. |
| 부호 없는 정수 | 계정이 이 신뢰선에 들어오는 잔액을 평가하는 비율(10억 단위당 이 값의 비율)입니다. (예를 들어 5억이라는 값은 0.5:1 비율을 나타냅니다.) 특별한 경우로 0은 1:1 비율로 처리됩니다. |
| 부호 없는 정수 | 계정이 이 신뢰선이 나가는 잔액을 평가하는 비율(10억 단위당 이 값의 비율)입니다. (예를 들어 5억이라는 값은 0.5:1 비율을 나타냅니다.) 특별한 경우로 0은 1:1 비율로 처리됩니다. |
| Boolean | |
| Boolean | (생략 가능) 참이면 피어 계정이 이 신뢰선에 대해 리플 없음 플래그를 활성화한 것입니다. 존재하고 거짓인 경우, 이 계정은 No Ripple 플래그를 비활성화했지만 기본 Ripple 플래그도 비활성화되어 있으므로 기본 상태로 간주되지 않습니다. 생략된 경우 계정은 이 신뢰 관계에 대해 리플 없음 플래그를 비활성화하고 기본 Ripple을 활성화한 상태입니다. |
| Boolean | (생략 가능) 참이면 이 계정이 이 신뢰선을 승인한 것입니다. 기본값은 거짓입니다. |
| Boolean | (생략 가능) 참이면 피어 계정이 이 신뢰선을 승인한 것입니다. 기본값은 거짓입니다. |
| Boolean | (생략 가능) true이면 이 계정이 이 신뢰선을 동결했습니다. 기본값은 거짓입니다. |
| Boolean | (생략 가능) true이면 피어 계정이 이 신뢰선을 동결했습니다. 기본값은 거짓입니다. |
발생 가능한 오류
일반적인 오류 유형입니다.
invalidParams - 하나 이상의 필드가 잘못 지정되었거나 하나 이상의 필수 필드가 누락되었습니다.
actNotFound - 요청의 계정 필드에 지정된 주소가 장부에 있는 계정과 일치하지 않습니다.
lgrNotFound - ledger_hash 또는 ledger_index로 지정한 ledger이 존재하지 않거나, 존재하지만 서버에 없는 경우입니다.
actMalformed - 제공된 마커 필드가 허용되지 않는 경우.
Last updated