nft_history
배열문자nft_history 명령은 조회 중인 NFT의 과거 트랜잭션 메타데이터를 클리오 서버에 요청합니다.
Note:
nft_history는 NFT와 관련된 성공적인 트랜잭션만 반환합니다.
요청 형식
요청 형식의 예시입니다:
요청에는 다음 매개변수가 포함됩니다:
Field | 유형 | 설명 |
nft_id | 문자열 | 대체 불가능한 토큰(NFT)의 고유 식별자입니다. |
ledger_index_min | 정수 | (선택 사항) NFT를 포함할 최초 원장을 지정하는 데 사용됩니다. 값은 -1서버가 사용 가능한 가장 먼저 검증된 원장 버전을 사용하도록 지시합니다. |
ledger_index_max | 정수 | (선택 사항) NFT를 포함할 가장 최근 원장을 지정하는 데 사용됩니다. 값은 -1서버가 사용 가능한 가장 최근에 검증된 원장 버전을 사용하도록 지시합니다. |
ledger_hash | 문자열 | (선택 사항) 사용할 원장 버전에 대한 20바이트 16진수 문자열입니다. (원장 지정 참조) |
ledger_index | 문자열 또는 부호 없는 정수 | |
binary | Boolean | (선택 사항) 기본값은 입니다 false로 설정된 경우 trueJSON 대신 16진수 문자열로 트랜잭션을 반환합니다. |
forward | Boolean | (선택 사항) 기본값은 입니다 false. 로 설정된 경우 true가장 오래된 원장으로 인덱싱된 값을 먼저 반환합니다. 그렇지 않으면 결과가 최신 원장으로 먼저 인덱싱됩니다. (결과의 각 페이지는 내부적으로 배열되지 않을 수 있지만 페이지는 전체적으로 배열됩니다.) |
limit | UInt32 | (선택 사항) 검색할 NFT 수를 제한합니다. 서버는 이 값을 준수할 필요가 없습니다. |
marker | marker | 이전에 페이지를 매긴 응답의 값입니다. 해당 응답이 중단된 데이터 검색을 재개합니다. 서버의 사용 가능한 원장 범위가 변경되면 이 값은 안정적이지 않습니다. "검증된" 원장을 쿼리하는 경우 페이징 중에 새로운 NFT가 생성될 수 있습니다. |
Note:
ledger 버전을 지정하지 않으면 클리오는 검증된 최신 ledger을 사용합니다.
응답 형식
성공적인 응답의 예입니다:
바이너리 매개변수를 true로 설정하면 16진수 문자열을 사용하는 간결한 응답을 받습니다. 사람이 읽을 수는 없지만 훨씬 더 간결합니다.
응답은 표준 형식을 따르며, 성공적인 결과에는 다음 필드가 포함됩니다:
Field | 유형 | 설명 |
nft_id | 문자열 | 대체 불가능한 토큰(NFT)의 고유 식별자입니다. |
ledger_index_min | 정수 - 원장 색인 | 최초 원장의 원장 색인은 실제로 거래를 검색한 것입니다. |
ledger_index_max | 정수 - 원장 색인 | 가장 최근 원장의 원장 색인이 실제로 거래를 검색한 것입니다. |
limit | 정수 | limit요청에 사용된 값입니다 . (실제 서버에서 적용하는 제한값과 다를 수 있습니다.) |
marker | 응답이 페이지로 매겨졌음을 나타내는 서버 정의 값입니다. 이 통화가 중단된 곳에서 재개하려면 이를 다음 통화에 전달하세요. | |
transactions | 배열 | 아래 설명된 대로 요청 기준과 일치하는 트랜잭션 배열입니다. |
validated | Boolean | 포함되고 true로 설정된 경우, 이 응답의 정보는 검증된 원장 버전에서 가져옵니다. 그렇지 않으면 정보가 변경될 수 있습니다. |
Note:
서버에 사용자가 지정한 버전이 없는 경우와 같이 서버가 요청에 제공한 것과 다른 ledger_index_min 및 ledger_index_max 값으로 응답할 수 있습니다.
각 트랜잭션 객체에는 JSON 또는 16진수 문자열 "binary":true 형식으로 요청되었는지 여부에 따라 다음과 같은 필드가 포함됩니다.
Field | 유형 | 설명 |
ledger_index | 정수 | 이 거래가 포함된 원장 버전의 원장 인덱스입니다. |
meta | 객체(JSON) 또는 문자열(바이너리) | True인 경우 binary이는 트랜잭션 메타데이터의 16진수 문자열입니다. 그렇지 않으면 트랜잭션 메타데이터가 JSON 형식으로 포함됩니다. |
tx | 객체 | (JSON 모드만 해당) 트랜잭션을 정의하는 JSON 객체 |
tx_blob | 문자열 | (바이너리 모드에만 해당) 트랜잭션을 나타내는 고유한 해시 문자열입니다. |
validated | Boolean | 거래가 검증된 원장에 포함되어 있는지 여부입니다. 아직 검증된 원장에 포함되지 않은 거래는 변경될 수 있습니다. |
tx 객체에 반환되는 필드에 대한 정의는 트랜잭션 메타데이터를 참조하세요.
발생 가능한 오류
일반적인 오류 유형입니다.
invalidParams - 하나 이상의 필드가 잘못 지정되었거나 하나 이상의 필수 필드가 누락되었습니다.
actMalformed - 요청의 계정 필드에 지정된 주소의 형식이 올바르지 않습니다.
lgrIdxMalformed - ledger_index_min 또는 ledger_index_max에 지정된 ledger이 존재하지 않거나, 존재하지만 서버에 없는 경우입니다.
lgrIdxsInvalid - 요청이 ledger_index_min보다 앞선 ledger_index_max를 지정하거나 서버가 네트워크와 동기화되지 않아 유효성이 검증된 ledger 범위를 가지고 있지 않은 경우입니다.
Last updated