RESTful API v2 </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#error-response-handling" class="sidebar-link">오류 응답 처리 </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#error-list" class="sidebar-link">오류 목록 </a></li></ul></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#request-type" class="sidebar-link">청 유형 </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#authentication-interface" class="sidebar-link">인증 인터페이스 </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#getuid" class="sidebar-link">getuid </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#login" class="sidebar-link">login </a></li></ul></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#server-side-command-interface" class="sidebar-link">서버 측 명령 인터페이스 </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#version" class="sidebar-link">버전 </a></li></ul></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#data-request-function-interface" class="sidebar-link">데이터 요청 기능 인터페이스 </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#balance" class="sidebar-link">balance </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#blocks" class="sidebar-link">blocks </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#detailed-blocks" class="sidebar-link">detailed_blocks </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#data-id-data-hash" class="sidebar-link">/data/{id}/data/{hash} </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#data-table-id-column-hash" class="sidebar-link">/data/{table}/id/{column}/{hash} </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#keyinfo" class="sidebar-link">keyinfo </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#wallethistory" class="sidebar-link">walletHistory </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#listwhere-name" class="sidebar-link">listWhere/{name} </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#nodelistwhere-name" class="sidebar-link">nodelistWhere/{name} </a></li></ul></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#get-metrics-interface" class="sidebar-link">메트릭 인터페이스 가져오기 </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#metrics-keys" class="sidebar-link">metrics/keys </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#metrics-blocks" class="sidebar-link">metrics/blocks </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#metrics-transactions" class="sidebar-link">metrics/transactions </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#metrics-ecosystems" class="sidebar-link">metrics/ecosystems </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#metrics-honornodes" class="sidebar-link">metrics/honornodes </a></li></ul></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#ecosystem-interface" class="sidebar-link">생태계 인터페이스 </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#ecosystemname" class="sidebar-link">ecosystemname </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#appparams-appid" class="sidebar-link">appparams/{appid} </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#appparam-appid-name" class="sidebar-link">appparam/{appid}/{name} </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#ecosystemparams" class="sidebar-link">ecosystemparams </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#ecosystemparam-name" class="sidebar-link">ecosystemparam/{name} </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#tables-limit-offset" class="sidebar-link">tables/\[?limit=\... &offset=\... \] </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#table-name" class="sidebar-link">table/{name} </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#list-name-limit-offset-columns" class="sidebar-link">list/{name}\[?limit=\... &offset=\... &columns=\... \] </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#sections-limit-offset-lang" class="sidebar-link">sections\[?limit=\... &offset=\... &lang=\] </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#row-name-id-columns" class="sidebar-link">row/{name}/{id}\[?columns=\] </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#row-name-colorn-id" class="sidebar-link">row/{name}/{column}/{id} </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#systemparams" class="sidebar-link">systemparams </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#history-name-id" class="sidebar-link">history/{name}/{id} </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#interface-page-menu-snippet-name" class="sidebar-link">interface/{page|menu|snippet}/{name} </a></li></ul></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#contract-function-interface" class="sidebar-link">계약 함수 인터페이스 </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#contracts-limit-offset" class="sidebar-link">contracts\[?limit=\... &offset=\... \] </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#contract-name" class="sidebar-link">contract/{name} </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#sendtx" class="sidebar-link">sendTX </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#txstatus" class="sidebar-link">txstatus </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#txinfo-hash" class="sidebar-link">txinfo/{hash} </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#txinfomultiple" class="sidebar-link">txinfoMultiple </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#page-validators-count-name" class="sidebar-link">/page/validators_count/{name} </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#content-menu-page-name" class="sidebar-link">content/menu\|page/{name} </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#content-source-name" class="sidebar-link">content/source/{name} </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#content-hash-name" class="sidebar-link">content/hash/{name} </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#content" class="sidebar-link">content </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#maxblockid" class="sidebar-link">maxblockid </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#block-id" class="sidebar-link">block/{id} </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#avatar-ecosystem-member" class="sidebar-link">avatar/{ecosystem}/{member} </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#config-centrifugo" class="sidebar-link">config/centrifugo </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#updnotificator" class="sidebar-link">updnotificator </a></li><li class="sidebar-sub-header"><a href="/kr/reference/api2.html#special-instructions" class="sidebar-link">특별한 지시사항이 있으신가요? </a></li></ul></li></ul></li><li><a href="/kr/reference/platform-parameters.html" class="sidebar-link">플랫폼 매개변수 </a></li><li><a href="/kr/reference/backend-config.html" class="sidebar-link">서버 구성 파일 </a></li><li><a href="/kr/reference/desync_monitor.html" class="sidebar-link">실시간 모니터링 도구 </a></li><li><a href="/kr/reference/json-rpc.html" class="sidebar-link">JSON-RPC API </a></li></ul></section></li></ul> </aside> <main class="page"> <div class="theme-default-content content__default"><h1 id="restful-api-v2"><a href="#restful-api-v2" class="header-anchor">#</a> RESTful API v2 </h1> <p>Weaver IBAX 블록체인 플랫폼의 REST API를 통해 인증, 생태계 데이터 수신, 오류 처리, 데이터베이스 테이블 조작, 페이지 및 컨트랙트 실행을 포함한 모든 기능을 제공합니다.</p> <p>REST API를 사용하면 Weaver를 사용하지 않고도 플랫폼의 모든 기능에 액세스할 수 있습니다.</p> <p>API 명령 호출은 <code>/api/v2/command/[param]</code>로 주소 지정을 통해 실행됩니다. 여기서 <code>command</code>는 명령어 이름이고 <code>param</code>은 추가 매개변수입니다. 요청 매개변수는 <code>Content-Type: x-www-form-urlencoded</code> 형식으로 지정되어야 합니다. 서버 응답 결과는 JSON 형식으로 반환됩니다.</p> <ul><li><a href="#error-response-handling">오류 응답 처리</a> <ul><li><a href="#error-list">오류 목록</a></li></ul></li> <li><a href="#request-type">요청 유형</a></li> <li><a href="#authentication-interface">인증 인터페이스</a> <ul><li><a href="#getuid">getuid</a></li> <li><a href="#login">login</a></li></ul></li> <li><a href="#server-side-command-interface">서버 측 명령 인터페이스</a> <ul><li><a href="#version">version</a></li></ul></li> <li><a href="#data-request-function-interface">데이터 요청 기능 인터페이스</a> <ul><li><a href="#balance">balance</a></li> <li><a href="#blocks">blocks</a></li> <li><a href="#detailed-blocks">detailed_blocks</a></li> <li><a href="#data-id-data-hash">/data/{id}/data/{hash}</a></li> <li><a href="#data-table-id-column-hash">/data/{table}/id/{column}/{hash}</a></li> <li><a href="#keyinfo">keyinfo</a></li> <li><a href="#wallethistory">walletHistory</a></li> <li><a href="#listwhere-name">listWhere/{name}</a></li> <li><a href="#nodelistwhere-name">nodelistWhere/{name}</a></li></ul></li> <li><a href="#get-metrics-interface">메트릭스 인터페이스</a> <ul><li><a href="#metrics-keys">metrics/keys</a></li> <li><a href="#metrics-blocks">metrics/blocks</a></li> <li><a href="#metrics-transactions">metrics/transactions</a></li> <li><a href="#metrics-ecosystems">metrics/ecosystems</a></li> <li><a href="#metrics-honornodes">metrics/honornodes</a></li></ul></li> <li><a href="#ecosystem-interface">생태계 인터페이스</a> <ul><li><a href="#ecosystemname">ecosystemname</a></li> <li><a href="#appparams-appid">appparams/{appID}</a></li> <li><a href="#appparam-appid-name">appparam/{appid}/{name}</a></li> <li><a href="#ecosystemparams">ecosystemparams</a></li> <li><a href="#ecosystemparam-name">ecosystemparam/{name}</a></li> <li><a href="#tables-limit-offset">tables/[?limit=... &offset=... ]</a></li> <li><a href="#table-name">table/{name}</a></li> <li><a href="#list-name-limit-offset-columns">list/{name}[?limit=... &offset=... &columns=... ]</a></li> <li><a href="#sections-limit-offset-lang">sections[?limit=... &offset=... &lang=]</a></li> <li><a href="#row-name-id-columns">row/{name}/{id}[?columns=]</a></li> <li><a href="#row-name-column-id">row/{name}/{column}/{id}</a></li> <li><a href="#systemparams">systemparams</a></li> <li><a href="#history-name-id">history/{name}/{id}</a></li> <li><a href="#interface-page-menu-snippet-name">interface/{page|menu|snippet}/{name}</a></li></ul></li> <li><a href="#contract-function-interface">Contract Function Interface</a> <ul><li><a href="#contracts-limit-offset">contracts[?limit=... &offset=... ]</a></li> <li><a href="#contract-name">contract/{name}</a></li> <li><a href="#sendtx">sendTX</a></li> <li><a href="#txstatus">txstatus</a></li> <li><a href="#txinfo-hash">txinfo/{hash}</a></li> <li><a href="#txinfomultiple">txinfoMultiple</a></li> <li><a href="#page-validators-count-name">/page/validators_count/{name}</a></li> <li><a href="#content-menu-page-name">content/menu|page/{name}</a></li> <li><a href="#content-source-name">content/source/{name}</a></li> <li><a href="#content-hash-name">content/hash/{name}</a></li> <li><a href="#content">content</a></li> <li><a href="#maxblockid">maxblockid</a></li> <li><a href="#block-id">block/{id}</a></li> <li><a href="#avatar-ecosystem-member">avatar/{ecosystem}/{member}</a></li> <li><a href="#config-centrifugo">config/centrifugo</a></li> <li><a href="#updnotificator">updnotificator</a></li></ul></li></ul> <h2 id="error-response-handling"><a href="#error-response-handling" class="header-anchor">#</a> 오류 응답 처리 </h2> <p>요청이 성공적으로 실행된 경우 반환 상태 <code>200</code>. 오류가 발생한 경우 오류 상태 외에도 다음 필드를 가진 JSON 객체가 반환됩니다.</p> <ul><li><p><strong>error</strong></p> <blockquote><p>오류 식별자.</p></blockquote></li> <li><p><strong>msg</strong></p> <blockquote><p>오류 텍스트 메시지.</p></blockquote></li> <li><p><strong>params</strong></p> <blockquote><p>오류 메시지에 추가로 추가될 수 있는 추가 매개 변수의 배열.</p></blockquote></li></ul> <h4 id=""><a href="#" class="header-anchor">#</a> 응답 예제</h4> <div class="language-text extra-class"><pre class="language-text"><code>400 (Bad 요청 예시) Content-Type: application/json { "err": "E_INVALIDWALLET", "msg": "Wallet 1234-5678-9012-3444-3488 is not valid", "params": ["1234-5678-9012-3444-3488"] } </code></pre></div><h3 id="error-list"><a href="#error-list" class="header-anchor">#</a> 오류 목록 </h3> <blockquote><p>E_CONTRACT</p></blockquote> <p><code>%s</code> 계약이 존재하지 않습니다.</p> <blockquote><p>E_DBNIL</p></blockquote> <div class="language- extra-class"><pre><code>데이터베이스가 비어 있습니다. </code></pre></div><blockquote><p>E_DELETEDKEY</p></blockquote> <div class="language- extra-class"><pre><code>계정 주소가 동결되었습니다. </code></pre></div><blockquote><p>E_ECOSYSTEM</p></blockquote> <div class="language- extra-class"><pre><code>생태계 `%d`가 존재하지 않습니다. </code></pre></div><blockquote><p>E_EMPTYPUBLIC</p></blockquote> <div class="language- extra-class"><pre><code>잘못된 계정 공개 키입니다. </code></pre></div><blockquote><p>E_KEYNOTFOUND</p></blockquote> <div class="language- extra-class"><pre><code>계정 주소를 찾을 수 없습니다. </code></pre></div><blockquote><p>E_HASHWRONG</p></blockquote> <div class="language- extra-class"><pre><code>잘못된 해시입니다. </code></pre></div><blockquote><p>E_HASHNOTFOUND</p></blockquote> <div class="language- extra-class"><pre><code>해시를 찾을 수 없습니다. </code></pre></div><blockquote><p>E_HEAVYPAGE</p></blockquote> <div class="language- extra-class"><pre><code>페이지 로딩이 너무 많습니다. </code></pre></div><blockquote><p>E_INVALIDWALLET</p></blockquote> <div class="language- extra-class"><pre><code>지갑 주소 `%s`가 잘못되었습니다. </code></pre></div><blockquote><p>E_LIMITTXSIZE</p></blockquote> <div class="language- extra-class"><pre><code>트랜잭션 크기가 제한을 초과했습니다. </code></pre></div><blockquote><p>E_NOTFOUND</p></blockquote> <div class="language- extra-class"><pre><code>페이지 또는 메뉴 내용을 찾을 수 없습니다. </code></pre></div><blockquote><p>E_PARAMNOTFOUND</p></blockquote> <div class="language- extra-class"><pre><code>매개 변수를 찾을 수 없습니다. </code></pre></div><blockquote><p>E_PERMISSION</p></blockquote> <div class="language- extra-class"><pre><code>권한이 없습니다. </code></pre></div><blockquote><p>E_QUERY</p></blockquote> <div class="language- extra-class"><pre><code>데이터베이스 쿼리 오류입니다. </code></pre></div><blockquote><p>E_RECOVERED</p></blockquote> <div class="language- extra-class"><pre><code>API 패닉 오류가 발생했습니다. 패닉 오류가 발생하면 오류가 반환됩니다. 이 오류는 버그를 발견하고 수정해야 함을 의미합니다. </code></pre></div><blockquote><p>E_SERVER</p></blockquote> <div class="language- extra-class"><pre><code>서버 오류입니다. golang 라이브러리 함수에 오류가 있는 경우 반환됩니다. \*msg\* 필드에는 오류 텍스트 메시지가 포함됩니다. **E_SERVER**는 어떤 명령의 오류로 인해 발생할 수 있습니다. 입력 매개 변수가 잘못된 경우 관련 오류로 변경할 수 있습니다. 다른 경우에는 이 오류는 잘못된 작업이나 올바르지 않은 시스템 구성을 나타내며, 자세한 조사 보고서가 필요합니다. </code></pre></div><blockquote><p>E_SIGNATURE</p></blockquote> <div class="language- extra-class"><pre><code>잘못된 서명입니다. </code></pre></div><blockquote><p>E_STATELOGIN</p></blockquote> <div class="language- extra-class"><pre><code>`%s`은(는) 생태계 `%s`의 구성원이 아닙니다. </code></pre></div><blockquote><p>E_TABLENOTFOUND</p></blockquote> <div class="language- extra-class"><pre><code>데이터 시트 `%s`을(를) 찾을 수 없습니다. </code></pre></div><blockquote><p>E_TOKENEXPIRED</p></blockquote> <div class="language- extra-class"><pre><code>세션이 만료되었습니다 `%s` </code></pre></div><blockquote><p>E_UNAUTHORIZED</p></blockquote> <div class="language- extra-class"><pre><code>인증되지 않음. 로그인이 수행되지 않았거나 세션이 만료된 경우, **getuid, login**을 제외한 모든 명령은 **E_UNAUTHORIZED** 오류를 반환합니다. </code></pre></div><blockquote><p>E_UNKNOWNUID</p></blockquote> <div class="language- extra-class"><pre><code>알 수 없는 UID입니다. </code></pre></div><blockquote><p>E_UPDATING</p></blockquote> <div class="language- extra-class"><pre><code>노드가 블록체인을 업데이트 중입니다. </code></pre></div><blockquote><p>E_STOPPING</p></blockquote> <div class="language- extra-class"><pre><code>노드가 중지되었습니다. </code></pre></div><blockquote><p>E_NOTIMPLEMENTED</p></blockquote> <div class="language- extra-class"><pre><code>아직 구현되지 않았습니다. </code></pre></div><blockquote><p>E_BANNED</p></blockquote> <div class="language- extra-class"><pre><code>이 계정 주소는 `%s`에서 금지되었습니다. </code></pre></div><blockquote><p>E_CHECKROLE</p></blockquote> <div class="language- extra-class"><pre><code>액세스가 거부되었습니다. CLB 사용 불가 인터페이스 </code></pre></div><hr> <blockquote><p>CLB 노드를 사용할 수 없는 인터페이스 요청.</p></blockquote> <ul><li>metrics</li> <li>txinfo</li> <li>txinfoMultiple</li> <li>appparam</li> <li>appparams</li> <li>appcontent</li> <li>history</li> <li>balance</li> <li>block</li> <li>maxblockid</li> <li>blocks</li> <li>detailed_blocks</li> <li>ecosystemparams</li> <li>systemparams</li> <li>ecosystems</li> <li>ecosystemparam</li> <li>ecosystemname</li> <li>walletHistory</li> <li>tx_record</li></ul> <h2 id="request-type"><a href="#request-type" class="header-anchor">#</a> 청 유형 </h2> <p><strong>균일한 사용</strong></p> <ul><li>application/x-www-form-urlencoded</li></ul> <h2 id="authentication-interface"><a href="#authentication-interface" class="header-anchor">#</a> 인증 인터페이스 </h2> <p><a href="https://jwt.io" target="_blank" rel="noopener noreferrer">JWT 토큰<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a> 인증에 사용됩니다. JWT 토큰은 수신된 후 각 요청 헤더에 배치되어야 합니다: <code>Authorization: Bearer TOKEN_HERE</code>.</p> <h3 id="getuid"><a href="#getuid" class="header-anchor">#</a> getuid </h3> <p><strong>GET</strong>/은 고유한 값을 반환하고 개인 키로 서명한 다음 <a href="#login">login</a> 명령은 이를 서버로 다시 보냅니다.</p> <p><strong>login</strong>을 호출할 때 <strong>Authorization</strong>에 전달해야 하는 임시 JWT 토큰을 생성합니다.</p> <h4 id="-2"><a href="#-2" class="header-anchor">#</a> 요청 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/getuid </code></pre></div><h4 id="-3"><a href="#-3" class="header-anchor">#</a> 응답</h4> <ul><li><p><em>uid</em></p> <blockquote><p>서명 번호입니다.</p></blockquote></li> <li><p><em>token</em></p> <blockquote><p>로그인 중 전달된 임시 토큰입니다.</p> <p>임시 토큰의 수명은 5초입니다.</p></blockquote></li> <li><p><em>network_id</em></p> <blockquote><p>서버 식별자입니다.</p></blockquote></li> <li><p><em>cryptoer</em></p> <blockquote><p>타원 곡선 알고리즘입니다.</p></blockquote></li> <li><p><em>hasher</em></p> <blockquote><p>해시 알고리즘입니다.</p></blockquote></li></ul> <h4 id="-4"><a href="#-4" class="header-anchor">#</a> 응답 예시 1</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "uid": "4999317241855959593", "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9....... .I7LY6XX4IP12En6nr8UPklE9U4qicqg3K9KEzGq_8zE" "network_id": "4717243765193692211" } </code></pre></div><p>다음은 인증이 필요하지 않은 경우 (요청에 <strong>Authorization</strong>이 포함되지 않은 경우) 반환되는 메시지입니다:</p> <ul><li><p><em>expire</em></p> <blockquote><p>만료 시간입니다.</p></blockquote></li> <li><p><em>ecosystem</em></p> <blockquote><p>생태계 ID입니다.</p></blockquote></li> <li><p><em>key_id</em></p> <blockquote><p>계정 주소입니다.</p></blockquote></li> <li><p><em>address</em></p> <blockquote><p>지갑 주소 <code>XXXX-XXXX-.....-XXXX</code>입니다.</p></blockquote></li> <li><p><em>network_id</em></p> <blockquote><p>서버 식별자입니다.</p></blockquote></li></ul> <h4 id="-5"><a href="#-5" class="header-anchor">#</a> 응답 예시 2</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "expire": "2159h59m49.4310543s", "ecosystem_id": "1", "key_id": "-654321", "address": "1196-...... -3496", "network_id": "1" } </code></pre></div><h4 id="-6"><a href="#-6" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_SERVER</em></p> <h3 id="login"><a href="#login" class="header-anchor">#</a> login </h3> <p><strong>POST</strong>/ 사용자 인증.</p> <blockquote><p>고유한 값을 받고 그것을 서명하기 위해 <strong>getuid</strong>를 호출해야 합니다. 요청 헤더에 getuid의 임시 JWT 토큰을 전달해야 합니다.</p> <p>요청이 성공하면 응답으로 받은 토큰이 <strong>Authorization</strong>에 포함됩니다.</p></blockquote> <h4 id="-7"><a href="#-7" class="header-anchor">#</a> 요청 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>POST /api/v2/login </code></pre></div><ul><li><p><em>[ecosystem]</em></p> <blockquote><p>생태계 ID.</p> <p>지정되지 않으면 첫 번째 생태계 ID로 기본 설정됩니다.</p></blockquote></li> <li><p><em>[expire]</em></p> <blockquote><p>JWT 토큰의 수명, 초 단위, 기본값은 28800입니다.</p></blockquote></li> <li><p><em>[pubkey]</em></p> <blockquote><p>16진수 계정 공개 키.</p></blockquote></li> <li><p><em>[key_id]</em></p> <blockquote><p>계정 주소 <code>XXXX-... -XXXX</code>.</p> <p>공개 키가 이미 블록체인에 저장된 경우 이 매개변수를 사용합니다. <em>pubkey</em> 매개변수와 함께 사용할 수 없습니다.</p></blockquote></li> <li><p><em>signature</em></p> <blockquote><p>getuid를 통해 받은 uid 서명.</p></blockquote></li></ul> <h4 id="-8"><a href="#-8" class="header-anchor">#</a> 응답</h4> <ul><li><p><em>token</em></p> <blockquote><p>JWT 토큰.</p></blockquote></li> <li><p><em>ecosystem_id</em></p> <blockquote><p>생태계 ID.</p></blockquote></li> <li><p><em>key_id</em></p> <blockquote><p>계정 주소 ID.</p></blockquote></li> <li><p><em>account</em></p> <blockquote><p>월렛 주소 <code>XXXX-XXXX-..... -XXXX</code>.</p></blockquote></li> <li><p><em>notify_key</em></p> <blockquote><p>알림 ID.</p></blockquote></li> <li><p><em>isnode</em></p> <blockquote><p>계정 주소가 노드 소유자인지 여부. 값: <code>true,false</code>.</p></blockquote></li> <li><p><em>isowner</em></p> <blockquote><p>계정 주소가 생태계 생성자인지 여부. 값: <code>true,false</code>.</p></blockquote></li> <li><p><em>clb</em></p> <blockquote><p>로그인한 생태계가 CLB인지 여부. 값: <code>true,false</code>.</p></blockquote></li> <li><p><em>roles</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p>역할 목록: <code>[{Role ID,Role Name}]</code>.</p></blockquote></li></ul> <h4 id="-9"><a href="#-9" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.....30l665h3v7lH85rs5jgk0", "ecosystem_id": "1", "key_id": "-54321", "account": "1285-... -7743-4282", "notify_key": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..... _JTFfheD0K4CfMbvVNpOJVMNDPx25zIDGir9g3ZZM0w", "timestamp": "1451309883", "roles": [ { "role_id": 1, "role_name": "Developer" } ] } </code></pre></div><h4 id="-10"><a href="#-10" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_SERVER, E_UNKNOWNUID, E_SIGNATURE, E_STATELOGIN, E_EMPTYPUBLIC</em></p> <h2 id="server-side-command-interface"><a href="#server-side-command-interface" class="header-anchor">#</a> 서버 측 명령 인터페이스 </h2> <h3 id="version"><a href="#version" class="header-anchor">#</a> 버전 </h3> <p><strong>GET</strong>/ 현재 서버 버전을 반환합니다.</p> <p>이 요청은 로그인 인증을 필요로하지 않습니다.</p> <h4 id="-11"><a href="#-11" class="header-anchor">#</a> 요청 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/version </code></pre></div><h4 id="-12"><a href="#-12" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json "1.3.0 branch.main commit.790..757 time.2021-08-23-08:20:19(UTC)" </code></pre></div><h2 id="data-request-function-interface"><a href="#data-request-function-interface" class="header-anchor">#</a> 데이터 요청 기능 인터페이스 </h2> <h3 id="balance"><a href="#balance" class="header-anchor">#</a> balance </h3> <p><strong>GET</strong>/ 현재 생태계의 계정 주소의 잔액을 요청합니다.</p> <p>이 요청은 로그인 인증을 필요로하지 않습니다.</p> <h4 id="-13"><a href="#-13" class="header-anchor">#</a> 요청 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/balance/{wallet} </code></pre></div><ul><li><p><em>wallet</em></p> <blockquote><p>주소 식별자로, <code>int64, uint64, XXXX-...-XXXX</code>와 같은 형식으로 지정할 수 있습니다. 사용자가 현재 로그인한 생태계에서 주소를 조회합니다.</p></blockquote></li> <li><p><em>[ecosystem]</em> <a href="#omitempty">Omitempty</a> Default eco1</p> <blockquote><p>생태계 ID.</p></blockquote></li></ul> <h4 id="-14"><a href="#-14" class="header-anchor">#</a> 응답</h4> <ul><li><p><em>amount</em></p> <blockquote><p>계약 계정 잔액의 최소 단위입니다.</p></blockquote></li> <li><p><em>money</em></p> <blockquote><p>계정 잔액입니다.</p></blockquote></li> <li><p><em>total</em></p> <blockquote><p>계정 잔액입니다.</p></blockquote></li> <li><p><em>utxo</em></p> <blockquote><p>UTXO 계정 잔액입니다.</p></blockquote></li></ul> <h4 id="-15"><a href="#-15" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "amount": "877450000000000", "money": "877.45", "total": "877450000000000", "utxo": "0" } </code></pre></div><h4 id="-16"><a href="#-16" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_SERVER, E_INVALIDWALLET</em></p> <h3 id="blocks"><a href="#blocks" class="header-anchor">#</a> blocks </h3> <p><strong>GET</strong>/ 각 블록의 트랜잭션에 관련된 추가 정보를 포함하는 목록을 반환합니다.</p> <p>이 요청은 로그인 인증이 필요하지 않습니다.</p> <h4 id="-17"><a href="#-17" class="header-anchor">#</a> 요청 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/blocks </code></pre></div><ul><li><p><em>block_id</em> <a href="#omitempty">Omitempty</a> 기본값은 0입니다.</p> <blockquote><p>조회할 시작 블록의 높이입니다.</p></blockquote></li> <li><p><em>count</em> <a href="#omitempty">Omitempty</a> (기본값은 25이며, 최대 요청 수는 1000입니다.)</p> <blockquote><p>블록의 개수입니다.</p></blockquote></li></ul> <h4 id="-18"><a href="#-18" class="header-anchor">#</a> 응답</h4> <ul><li><p>블록 높이</p> <blockquote><p>블록 내의 트랜잭션 목록과 각 트랜잭션에 대한 추가 정보입니다.</p> <blockquote><ul><li><em>hash</em></li></ul> <blockquote><p>거래 해시입니다.</p></blockquote> <ul><li><em>contract_name</em></li></ul> <blockquote><p>컨트랙트 이름입니다.</p></blockquote> <ul><li><em>params</em></li></ul> <blockquote><p>컨트랙트 매개변수의 배열입니다.</p></blockquote> <ul><li><em>key_id</em></li></ul> <blockquote><p>첫 번째 블록의 경우 트랜잭션을 서명한 첫 번째 블록의 계정 주소입니다.</p></blockquote> <blockquote><p>다른 모든 블록의 경우 트랜잭션을 서명한 계정의 주소입니다.</p></blockquote></blockquote></blockquote></li></ul> <h4 id="-19"><a href="#-19" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "1": [{"hash": "O1LhrjKznrYa0z5n5cej6p5Y1j5E9v/oV27VPRJmfgo=", "contract_name":"", "params":null, "key_id":-118432674655542910}] } </code></pre></div><h4 id="-20"><a href="#-20" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_SERVER, E_NOTFOUND</em></p> <h3 id="detailed-blocks"><a href="#detailed-blocks" class="header-anchor">#</a> detailed_blocks </h3> <p><strong>GET</strong>/ 각 블록의 트랜잭션에 대한 상세한 추가 정보가 포함된 목록을 반환합니다.</p> <p>이 요청은 로그인 인증이 필요하지 않습니다.</p> <h4 id="-21"><a href="#-21" class="header-anchor">#</a> 요청 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/detailed_blocks </code></pre></div><p><strong>GET</strong>/ 각 블록의 트랜잭션에 대한 상세한 추가 정보가 포함된 목록을 반환합니다.</p> <p>이 요청은 로그인 인증이 필요하지 않습니다.</p> <ul><li><p><em>block_id</em> <a href="#omitempty">Omitempty</a> 기본값은 0</p> <blockquote><p>조회할 시작 블록의 높이입니다.</p></blockquote></li> <li><p><em>count</em> <a href="#omitempty">Omitempty</a> (기본값은 25, 최대 요청은 1000)</p> <blockquote><p>블록 수입니다.</p></blockquote></li></ul> <h4 id="-22"><a href="#-22" class="header-anchor">#</a> 응답</h4> <ul><li><p>블록 높이</p> <blockquote><ul><li><em>blockhead</em></li></ul> <blockquote><p>블록 헤더에는 다음 필드가 포함됩니다.</p> <blockquote><ul><li><em>block_id</em></li></ul></blockquote> <blockquote><blockquote><p>블록 높이입니다.</p></blockquote></blockquote> <blockquote><ul><li><em>time</em></li></ul></blockquote> <blockquote><blockquote><p>블록 생성 타임스탬프입니다.</p></blockquote></blockquote> <blockquote><ul><li><em>key_id</em></li></ul></blockquote> <blockquote><blockquote><p>트랜잭션에 서명한 블록의 계정 주소입니다.</p></blockquote></blockquote> <blockquote><ul><li><em>node_position</em></li></ul></blockquote> <blockquote><blockquote><p>블록을 생성한 노드의 위치입니다. (honor node 목록 내)</p></blockquote></blockquote> <blockquote><ul><li><em>version</em></li></ul></blockquote> <blockquote><blockquote><p>블록 구조 버전입니다.</p></blockquote></blockquote></blockquote> <ul><li><em>hash</em></li></ul> <blockquote><p>블록 해시입니다.</p></blockquote> <ul><li><em>node_position</em></li></ul> <blockquote><p>블록을 생성한 노드의 위치입니다.</p></blockquote> <ul><li><em>key_id</em></li></ul> <blockquote><p>블록에 서명한 계정의 주소입니다.</p></blockquote> <ul><li><em>time</em></li></ul> <blockquote><p>블록 생성 타임스탬프입니다.</p></blockquote> <ul><li><em>tx_count</em></li></ul> <blockquote><p>블록 내의 트랜잭션 수입니다.</p></blockquote> <ul><li><em>size</em></li></ul> <blockquote><p>블록 크기입니다.</p></blockquote> <ul><li><em>rollback_hash</em></li></ul> <blockquote><p>블록 롤백 해시입니다.</p></blockquote> <ul><li><em>merkle_root</em></li></ul> <blockquote><p>블록에서 사용되는 Merkle 트리입니다.</p></blockquote> <ul><li><em>bin_data</em></li></ul> <blockquote><p>블록 헤더, 블록 내의 모든 트랜잭션, 이전 블록 해시, 블록을 생성한 노드의 개인 키의 직렬화입니다.</p></blockquote> <ul><li><em>trading</em></li></ul> <blockquote><p>블록 내의 트랜잭션 목록과 각 트랜잭션에 대한 추가 정보입니다.</p> <blockquote><ul><li><em>hash</em></li></ul></blockquote> <blockquote><blockquote><p>트랜잭션 해시입니다.</p></blockquote></blockquote> <blockquote><ul><li><em>contract_name</em></li></ul></blockquote> <blockquote><blockquote><p>계약 이름입니다.</p></blockquote></blockquote> <blockquote><ul><li><em>params</em></li></ul></blockquote> <p>계약 매개변수입니다.</p> <blockquote><ul><li><em>key_id</em></li></ul></blockquote> <blockquote><blockquote><p>이 트랜잭션에 대한 계정 주소에 서명합니다.</p></blockquote></blockquote> <blockquote><ul><li><em>time</em></li></ul></blockquote> <blockquote><blockquote><p>트랜잭션 생성 타임스탬프입니다.</p></blockquote></blockquote> <blockquote><ul><li><em>type</em></li></ul></blockquote> <blockquote><blockquote><p>트랜잭션 유형입니다.</p></blockquote></blockquote> <blockquote><ul><li><em>size</em></li></ul></blockquote> <blockquote><blockquote><p>거래 크기입니다.</p></blockquote></blockquote></blockquote></blockquote></li></ul> <h4 id="-23"><a href="#-23" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json {"1": {"header": {"block_id":1, "time":1551069320, "ecosystem_id":0, "key_id":-118432674655542910, "node_position":0, "version":1}, "hash":"3NxhvswmpGvRdw8HdkrniI5Mx/q14Z4d5hwGKMp6KHI=", "ecosystem_id":0, "node_position":0, "key_id":-118432674655542910, "time":1551069320, "tx_count":1, "size": "1.69KiB", "rollbacks_hash":"I2JHugpbdMNxBdNW1Uc0XnbiXFtzB74yD9AK5YI5i/k=", "mrkl_root":"MTZiMjY2NGJjOWY3MDAyODlhYjkyMDVhZDQwNDgxNzkxMjY1MWJjNjczNDkyZjk5MWI2Y2JkMjAxNTIwYjUyYg==", "bin_data":null, "sys_update":false, "gen_block":false, "stop_count":0, "transactions":[ { "hash":"O1LhrjKznrYa0z5n5cej6p5Y1j5E9v/oV27VPRJmfgo=", "contract_name":"", "params":null, "key_id":0, "time":0, "type":0, "size": "300.00B" } ]} } </code></pre></div><h4 id="-24"><a href="#-24" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_SERVER, E_NOTFOUND</em></p> <h3 id="data-id-data-hash"><a href="#data-id-data-hash" class="header-anchor">#</a> /data/{id}/data/{hash} </h3> <p><strong>GET</strong>/ 지정된 해시가 이진 시계, 필드 및 레코드의 데이터와 일치하는 경우, 이 요청은 데이터를 반환합니다. 그렇지 않은 경우, 오류가 반환됩니다.</p> <p>이 요청은 로그인 인증을 필요로하지 않습니다.</p> <h4 id="-25"><a href="#-25" class="header-anchor">#</a> 요청 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>GET /data/{id}/data/{hash} </code></pre></div><ul><li><p><em>id</em></p> <blockquote><p>레코드 ID.</p></blockquote></li> <li><p><em>hash</em></p> <blockquote><p>요청 데이터의 해시.</p></blockquote></li></ul> <h4 id="-26"><a href="#-26" class="header-anchor">#</a> 응답</h4> <blockquote><p>이진 데이터</p></blockquote> <h4 id="-27"><a href="#-27" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: * { "name": "NFT Miner", "conditions": "ContractConditions(\"@1DeveloperCondition\")", "data": [ { "Type": "contracts", "Name": "NewNFTMiner", }, ... ] } </code></pre></div><h4 id="-28"><a href="#-28" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_SERVER, E_NOTFOUND, E_HASHWRONG</em></p> <h3 id="data-table-id-column-hash"><a href="#data-table-id-column-hash" class="header-anchor">#</a> /data/{table}/id/{column}/{hash} </h3> <p><strong>GET</strong>/ 지정된 테이블, 필드 및 레코드의 데이터와 지정된 해시가 일치하는 경우, 요청에 대한 데이터가 반환됩니다. 그렇지 않으면 오류가 반환됩니다.</p> <p>이 요청은 로그인 인증을 필요로하지 않습니다.</p> <h4 id="-29"><a href="#-29" class="header-anchor">#</a> 요청 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>GET /data/{table}/id/{column}/{hash} </code></pre></div><ul><li><p><em>table</em></p> <blockquote><p>데이터 테이블 이름.</p></blockquote></li> <li><p><em>id</em></p> <blockquote><p>레코드 ID.</p></blockquote></li> <li><p><em>column</em></p> <blockquote><p>데이터 테이블 이름, 하나만 가능합니다.</p></blockquote></li> <li><p><em>hash</em></p> <blockquote><p>요청 데이터의 해시.</p></blockquote></li></ul> <h4 id="-30"><a href="#-30" class="header-anchor">#</a> 응답</h4> <blockquote><p>바이너리 데이터</p></blockquote> <h4 id="-31"><a href="#-31" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/octet-stream Content-Disposition: attachment SetVar(this_page, @1voting_list).(this_table, @1votings) Include(@1pager_header) SetTitle("$@1voting_list$") Span(Class: text-muted h5 m0 mb ml-lg, Body: Span(Class: ml-sm, Body: "$@1votings_list_desc$")) AddToolButton(Title: $@1templates_list$, Page: @1voting_templates_list, Icon: icon-pin) AddToolButton(Title: $@1create$, Page: @1voting_create, Icon: icon-plus).Popup(60, $@1new_voting$) </code></pre></div><h4 id="-32"><a href="#-32" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_SERVER, E_NOTFOUND, E_HASHWRONG</em></p> <h3 id="keyinfo"><a href="#keyinfo" class="header-anchor">#</a> keyinfo </h3> <p><strong>GET</strong>/ 지정된 주소를 등록한 역할이 포함된 생태계 목록으로 돌아갑니다.</p> <p>요청에 로그인 인증이 필요하지 않습니다.</p> <h4 id="-33"><a href="#-33" class="header-anchor">#</a> 요청 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/keyinfo/{address} </code></pre></div><ul><li><p><em>address</em></p> <blockquote><p>주소 식별자입니다. <code>int64, uint64, xxxx -...-xxxx</code>와 같은 형식으로 지정할 수 있습니다.</p> <p>이 요청은 모든 생태계에서 쿼리됩니다.</p></blockquote></li></ul> <h4 id="-34"><a href="#-34" class="header-anchor">#</a> 응답</h4> <ul><li><p><em>ecosystem</em></p> <blockquote><p>생태계 ID.</p></blockquote></li> <li><p><em>name</em></p> <blockquote><p>생태계 이름.</p></blockquote></li> <li><p><em>roles</em></p> <blockquote><p><em>id</em>와 <em>name</em> 필드를 가진 활동들.</p></blockquote></li></ul> <h4 id="-35"><a href="#-35" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json [{ "ecosystem":"1", "name":"platform ecosystem", "roles":[{"id":"1","name":"Governancer"},{"id":"2","name":"Developer"}] }] </code></pre></div><h4 id="-36"><a href="#-36" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_SERVER, E_INVALIDWALLET</em></p> <h3 id="wallethistory"><a href="#wallethistory" class="header-anchor">#</a> walletHistory </h3> <p><strong>GET</strong>/ 현재 계정의 거래 내역 기록을 반환하며, ID에 따라 해당 내역을 찾습니다.</p> <p><a href="#authorization">권한 부여</a></p> <h4 id="-37"><a href="#-37" class="header-anchor">#</a> 요청</h4> <ul><li><p><em>searchType</em></p> <blockquote><p>찾을 유형 (Income: 수입, Outcome: 지출, All: 전체, 기본값).</p></blockquote></li> <li><p><em>[page]</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p>페이지 번호, 기본값은 첫 번째 페이지, 최소값: 1</p></blockquote></li> <li><p><em>[limit]</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p>표시할 거래 수, 기본값은 20개, 최소값: 1, 최대값: 500</p></blockquote></li></ul> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/walletHistory?searchType=all&page=1&limit=10 </code></pre></div><h4 id="-38"><a href="#-38" class="header-anchor">#</a> 응답</h4> <ul><li><p><em>total</em></p> <blockquote><p>항목의 총 개수.</p></blockquote></li> <li><p><em>page</em></p> <p>현재 페이지 번호.</p></li> <li><p><em>limit</em></p> <blockquote><p>한 번에 조회할 항목 수.</p></blockquote></li> <li><p><em>list</em></p> <blockquote><p>배열의 각 요소는 다음 매개변수를 포함합니다:</p></blockquote> <ul><li><em>id</em> <blockquote><p>Stripe ID.</p></blockquote></li> <li><em>sender_id</em> <blockquote><p>발송 key_id</p></blockquote></li> <li><em>sender_add</em> <blockquote><p>발송 계정 주소</p></blockquote></li> <li><em>recipient_id</em> <blockquote><p>수신 key_id</p></blockquote></li> <li><em>recipient_add</em> <blockquote><p>수신 계정 주소</p></blockquote></li> <li><em>amount</em> <blockquote><p>거래 금액</p></blockquote></li> <li><em>comment</em> <blockquote><p>거래 비고</p></blockquote></li> <li><em>block_id</em> <blockquote><p>블록 높이</p></blockquote></li> <li><em>tx_hash</em> <blockquote><p>거래 해시</p></blockquote></li> <li><em>created_at</em> <blockquote><p>거래 생성 시간, 밀리초 타임스탬프</p></blockquote></li> <li><em>money</em> <blockquote><p>거래 금액</p></blockquote></li></ul></li></ul> <h4 id="-39"><a href="#-39" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "page": 1, "limit": 10, "total": 617, "list": [ { "id": 650, "sender_id": 666081971617879..., "sender_add": "0666-0819-7161-xxxx-5186", "recipient_id": 666081971617879..., "recipient_add": "0666-0819-7161-xxxx-5186", "amount": "242250000", "comment": "taxes for execution of @1Export contract", "block_id": 209, "tx_hash": "a213bc767d710a223856d83515d53518075b56fb9e9c063bce8a256c20ff0775", "created_at": 1666001092090, "money": "0.00024225" } ... ] } </code></pre></div><h4 id="-40"><a href="#-40" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_SERVER</em></p> <h3 id="listwhere-name"><a href="#listwhere-name" class="header-anchor">#</a> listWhere/{name} </h3> <h4 id="-41"><a href="#-41" class="header-anchor">#</a> 요청 예시</h4> <p><strong>GET</strong>/ 현재 생태계에서 지정된 데이터 테이블의 항목을 반환합니다. 반환할 열을 지정할 수 있습니다.</p> <p><a href="#authorization">인증</a></p> <ul><li><p><em>name</em></p> <blockquote><p>데이터 테이블 이름.</p></blockquote></li> <li><p><em>[limit]</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p>한 페이지당 불러올 데이터 수, 기본값 25입니다.</p></blockquote></li> <li><p><em>[offset]</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p>반환 시작 위치, 기본값은 0입니다.</p></blockquote></li> <li><p><em>[order]</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p>정렬 방식, 기본값은 <code>id ASC</code>입니다.</p></blockquote></li> <li><p><em>[columns]</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p>쉼표로 구분된 반환할 열의 목록입니다. 지정되지 않으면 모든 열을 반환합니다. 모든 경우에 <code>id</code> 열이 반환됩니다.</p></blockquote></li> <li><p><em>[where]</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p>질의 조건</p> <p>예시: id> 2 및 name = john을 조회하려면</p> <p>다음을 사용할 수 있습니다: where: {"id": {"$ gt": 2}, "name": {"$eq": "john"}}</p> <p>자세한 내용은 <a href="/kr/topics/script.html#dbfind">DBFind</a> Where 구문을 참조하세요.</p></blockquote></li></ul> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/listWhere/mytable </code></pre></div><h4 id="-42"><a href="#-42" class="header-anchor">#</a> 응답</h4> <ul><li><p><em>count</em></p> <blockquote><p>항목의 총 개수.</p></blockquote></li> <li><p><em>list</em></p> <blockquote><p>배열의 각 요소는 다음 매개변수를 포함합니다:</p></blockquote> <ul><li><p><em>id</em></p> <blockquote><p>Stripe ID</p></blockquote></li> <li><p><em>...</em></p> <blockquote><p>데이터 테이블의 다른 열</p></blockquote></li></ul></li></ul> <h4 id="-43"><a href="#-43" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "count": 1, "list": [ { "account": "xxxx-0819-7161-xxxx-xxxx", "ecosystem": "1", "id": "12", "key": "avatar", "value": "{\"binary_id\": 4}" } ] } </code></pre></div><h4 id="-44"><a href="#-44" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_SERVER</em>,<em>E_TABLENOTFOUND</em></p> <h3 id="nodelistwhere-name"><a href="#nodelistwhere-name" class="header-anchor">#</a> nodelistWhere/{name} </h3> <p><strong>GET</strong>/특정 데이터 테이블로 돌아갑니다. 반환할 열을 지정할 수 있습니다. 데이터 테이블의 유형은 <strong>BYTEA</strong>이며, 16진수 인코딩 처리를 합니다.</p> <p><a href="#authorization">인증</a></p> <h4 id="-45"><a href="#-45" class="header-anchor">#</a> 요청</h4> <ul><li><p><em>name</em></p> <blockquote><p>데이터 테이블 이름.</p></blockquote></li> <li><p><em>[limit]</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p>크레딧 번호, 기본값은 25입니다.</p></blockquote></li> <li><p><em>[offset]</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p>처분, 기본값은 0입니다.</p></blockquote></li> <li><p><em>[order]</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p>정렬 방법, 기본 <code>id ASC</code>.</p></blockquote></li> <li><p><em>[columns]</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p>요청 열 목록은 쉼표로 구분됩니다. 지정하지 않으면 모든 열이 반환됩니다. 모든 경우에 <code>id</code> 열이 반환됩니다.</p></blockquote></li> <li><p><em>[where]</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p>쿼리 조건</p> <p>예: id> 2 및 name = john을 조회하려면</p> <p>다음과 같이 사용할 수 있습니다 : where: {"id": {"$gt": 2}, "name": {"$eq": "john"}}</p> <p>자세한 내용은 [DBFind](../ topics/script.md#dbfind) where 구문을 참조하십시오.</p></blockquote></li></ul> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/nodelistWhere/mytable </code></pre></div><h4 id="-46"><a href="#-46" class="header-anchor">#</a> 응답</h4> <ul><li><p><em>count</em></p> <blockquote><p>엔트리의 총 개수.</p></blockquote></li> <li><p><em>list</em></p> <blockquote><p>배열의 각 요소에는 다음 매개변수가 포함됩니다:</p></blockquote> <ul><li><p><em>id</em></p> <blockquote><p>Stripe ID.</p></blockquote></li> <li><p><em>...</em></p> <blockquote><p>데이터 테이블의 다른 열.</p></blockquote></li></ul></li></ul> <h4 id="-47"><a href="#-47" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "count": 1, "list": [ { "account": "xxxx-0819-7161-xxxx-xxxx", "ecosystem": "1", "id": "12", "key": "avatar", "value": "{\"binary_id\": 4}" } ] } </code></pre></div><h4 id="-48"><a href="#-48" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_SERVER</em>,<em>E_TABLENOTFOUND</em></p> <h2 id="get-metrics-interface"><a href="#get-metrics-interface" class="header-anchor">#</a> 메트릭 인터페이스 가져오기 </h2> <h3 id="metrics-keys"><a href="#metrics-keys" class="header-anchor">#</a> metrics/keys </h3> <p><strong>GET</strong>/ 생태계 1 계정 주소의 수를 반환합니다.</p> <h4 id="-49"><a href="#-49" class="header-anchor">#</a> 요청 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/metrics/keys </code></pre></div><h4 id="-50"><a href="#-50" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "count": 28 } </code></pre></div><h3 id="metrics-blocks"><a href="#metrics-blocks" class="header-anchor">#</a> metrics/blocks </h3> <p><strong>GET</strong>/ 블록 수를 반환합니다.</p> <h4 id="-51"><a href="#-51" class="header-anchor">#</a> 요청 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/metrics/blocks </code></pre></div><h4 id="-52"><a href="#-52" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "count": 28 } </code></pre></div><h3 id="metrics-transactions"><a href="#metrics-transactions" class="header-anchor">#</a> metrics/transactions </h3> <p><strong>GET</strong>/ 총 트랜잭션 수를 반환합니다.</p> <h4 id="-53"><a href="#-53" class="header-anchor">#</a> 요청 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/metrics/transactions </code></pre></div><h4 id="-54"><a href="#-54" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "count": 28 } </code></pre></div><h3 id="metrics-ecosystems"><a href="#metrics-ecosystems" class="header-anchor">#</a> metrics/ecosystems </h3> <p><strong>GET</strong>/ 생태계의 수를 반환합니다.</p> <h4 id="-55"><a href="#-55" class="header-anchor">#</a> 요청 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/metrics/ecosystems </code></pre></div><h4 id="-56"><a href="#-56" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "count": 28 } </code></pre></div><h3 id="metrics-honornodes"><a href="#metrics-honornodes" class="header-anchor">#</a> metrics/honornodes </h3> <p><strong>GET</strong>/ 명예 노드 수를 반환합니다.</p> <p>이 요청에는 로그인 인증이 필요하지 않습니다.</p> <div class="language- extra-class"><pre class="language-text"><code>GET /api/v2/metrics/honornodes </code></pre></div><h4 id="-57"><a href="#-57" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "count": 28 } </code></pre></div><h2 id="ecosystem-interface"><a href="#ecosystem-interface" class="header-anchor">#</a> 생태계 인터페이스 </h2> <h3 id="ecosystemname"><a href="#ecosystemname" class="header-anchor">#</a> ecosystemname </h3> <p><strong>GET</strong>/ 식별자로 생태계의 이름을 반환합니다.</p> <p>이 요청에는 로그인 인증이 필요하지 않습니다.</p> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/ecosystemname?id=1 </code></pre></div><ul><li><p><em>id</em></p> <blockquote><p>생태계 ID.</p></blockquote></li></ul> <h4 id="-58"><a href="#-58" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "ecosystem_name": "platform_ecosystem" } </code></pre></div><h4 id="-59"><a href="#-59" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_PARAMNOTFOUND</em></p> <h3 id="appparams-appid"><a href="#appparams-appid" class="header-anchor">#</a> appparams/{appid} </h3> <p><a href="#authorization">권한 부여</a></p> <p><strong>GET</strong>/ 현재 또는 지정된 생태계의 애플리케이션 매개변수 목록을 반환합니다.</p> <h4 id="-60"><a href="#-60" class="header-anchor">#</a> 요청 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/appparams/{appid} </code></pre></div><ul><li><p><em>[appid]</em></p> <blockquote><p>애플리케이션 ID.</p></blockquote></li> <li><p><em>[ecosystem]</em></p> <blockquote><p>생태계 ID; 지정되지 않은 경우 현재 생태계 매개변수가 반환됩니다.</p></blockquote></li> <li><p><em>[names]</em></p> <blockquote><p>수신된 매개변수의 목록입니다.</p> <p>쉼표로 구분된 매개변수 이름의 목록을 지정할 수 있습니다. 예: <code>/api/v2/appparams/1?names=name,mypar</code>.</p></blockquote></li></ul> <h4 id="-61"><a href="#-61" class="header-anchor">#</a> 응답</h4> <ul><li><p><em>list</em></p> <blockquote><p>배열의 각 요소는 다음 매개변수를 포함합니다.</p> <ul><li><em>name</em>, 매개변수의 이름입니다.</li> <li><em>value</em>, 매개변수의 값입니다.</li> <li><em>conditions</em>, 매개변수의 권한을 변경합니다.</li></ul></blockquote></li></ul> <h4 id="-62"><a href="#-62" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "list": [{ "name": "name", "value": "MyState", "conditions": "true", }, { "name": "mypar", "value": "My value", "conditions": "true", }, ] } </code></pre></div><h4 id="-63"><a href="#-63" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_ECOSYSTEM</em></p> <h3 id="appparam-appid-name"><a href="#appparam-appid-name" class="header-anchor">#</a> appparam/{appid}/{name} </h3> <p><a href="#authorization">권한 부여</a></p> <p><strong>GET</strong>/ 현재 또는 지정된 생태계에서 애플리케이션 **{name}**의 <strong>{appid}</strong> 매개변수를 반환합니다. 다음과 관련된 정보:</p> <h4 id="-64"><a href="#-64" class="header-anchor">#</a> 요청 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/appparam/{appid}/{name}[?ecosystem=1] </code></pre></div><ul><li><p><em>appid</em></p> <blockquote><p>애플리케이션 ID입니다.</p></blockquote></li> <li><p><em>name</em></p> <blockquote><p>요청한 매개변수의 이름입니다.</p></blockquote></li> <li><p><em>[ecosystem]</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p>에코시스템 ID (선택적 매개변수)입니다.</p> <p>기본값으로 현재 에코시스템을 반환합니다.</p></blockquote></li></ul> <h4 id="-65"><a href="#-65" class="header-anchor">#</a> 응답</h4> <ul><li><p><em>id</em></p> <blockquote><p>매개변수 ID입니다.</p></blockquote></li> <li><p><em>name</em></p> <blockquote><p>매개변수 이름입니다.</p></blockquote></li> <li><p><em>value</em></p> <blockquote><p>매개변수 값입니다.</p></blockquote></li> <li><p><em>conditions</em></p> <blockquote><p>매개변수 변경 권한입니다.</p></blockquote></li></ul> <h4 id="-66"><a href="#-66" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "id": "10", "name": "par", "value": "My value", "conditions": "true" } </code></pre></div><h4 id="-67"><a href="#-67" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_ECOSYSTEM, E_PARAMNOTFOUND</em></p> <h3 id="ecosystemparams"><a href="#ecosystemparams" class="header-anchor">#</a> ecosystemparams </h3> <p><a href="#authorization">권한 부여</a></p> <p><strong>GET</strong>/ 생태계 매개변수 목록을 반환합니다.</p> <h4 id="-68"><a href="#-68" class="header-anchor">#</a> 요청 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/ecosystemparams/[?ecosystem=... &names=...] </code></pre></div><ul><li><p><em>[ecosystem]</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p>에코시스템 ID입니다. 지정하지 않으면 현재 에코시스템 ID가 반환됩니다.</p></blockquote></li> <li><p><em>[names]</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p>쉼표로 구분된 요청 매개변수의 목록입니다.</p> <p>예시: <code>/api/v2/ecosystemparams/?names=name,currency,logo</code>.</p></blockquote></li></ul> <h4 id="-69"><a href="#-69" class="header-anchor">#</a> 응답</h4> <ul><li><p><em>list</em></p> <blockquote><p>배열의 각 요소는 다음과 같은 매개변수를 포함합니다.</p> <ul><li><em>name</em></li></ul> <blockquote><p>매개변수 이름입니다.</p></blockquote> <ul><li><em>value</em></li></ul> <blockquote><p>매개변수 값입니다.</p></blockquote> <ul><li><em>conditions</em></li></ul> <blockquote><p>매개변수 변경 권한입니다.</p></blockquote></blockquote></li></ul> <h4 id="-70"><a href="#-70" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "list": [{ "name": "name", "value": "MyState", "conditions": "true", }, { "name": "currency", "value": "MY", "conditions": "true", }, ] } </code></pre></div><h4 id="-71"><a href="#-71" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_ECOSYSTEM</em></p> <h3 id="ecosystemparam-name"><a href="#ecosystemparam-name" class="header-anchor">#</a> ecosystemparam/{name} </h3> <p><a href="#authorization">권한 부여</a></p> <p><strong>GET</strong>/ 현재 또는 지정된 생태계에서 <strong>{name}</strong> 매개변수에 대한 정보를 반환합니다.</p> <h4 id="-72"><a href="#-72" class="header-anchor">#</a> 요청 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/ecosystemparam/{name}[?ecosystem=1] </code></pre></div><ul><li><p><em>name</em></p> <blockquote><p>요청된 매개변수의 이름입니다.</p></blockquote></li> <li><p><em>[ecosystem]</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p>기본값은 현재 에코시스템 ID를 반환합니다.</p></blockquote></li></ul> <h4 id="-73"><a href="#-73" class="header-anchor">#</a> 응답</h4> <ul><li><p><em>name</em></p> <blockquote><p>매개변수 이름입니다.</p></blockquote></li> <li><p><em>value</em></p> <blockquote><p>매개변수 값입니다.</p></blockquote></li> <li><p><em>conditions</em></p> <blockquote><p>매개변수 변경 권한입니다.</p></blockquote></li></ul> <h4 id="-74"><a href="#-74" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "name": "currency", "value": "MYCUR", "conditions": "true" } </code></pre></div><h4 id="-75"><a href="#-75" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_ECOSYSTEM</em></p> <h3 id="tables-limit-offset"><a href="#tables-limit-offset" class="header-anchor">#</a> tables/[?limit=... &offset=... ] </h3> <p><a href="#authorization">권한 부여</a></p> <p><strong>GET</strong>/ 현재 에코시스템의 데이터 테이블 목록을 반환합니다. 오프셋과 항목 수를 설정할 수 있습니다.</p> <h4 id="-76"><a href="#-76" class="header-anchor">#</a> 요청</h4> <ul><li><p><em>[limit]</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p>항목 수, 기본값은 100이며, 최대 1000입니다.</p></blockquote></li> <li><p><em>[offset]</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p>오프셋, 기본값은 0입니다.</p></blockquote></li></ul> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/tables?limit=... &offset=... </code></pre></div><h4 id="-77"><a href="#-77" class="header-anchor">#</a> 응답</h4> <ul><li><p><em>count</em></p> <blockquote><p>데이터 테이블에 있는 항목의 총 수.</p></blockquote></li> <li><p><em>list</em></p> <blockquote><p>배열의 각 요소는 다음과 같은 매개변수를 포함합니다.</p> <blockquote><ul><li><em>name</em></li></ul> <blockquote><p>접두사를 제외한 데이터 테이블의 이름입니다.</p></blockquote> <ul><li><em>count</em></li></ul> <blockquote><p>데이터 테이블에 있는 항목 수입니다.</p></blockquote></blockquote></blockquote></li></ul> <h4 id="-78"><a href="#-78" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "count": "100" "list": [{ "name": "accounts", "count": "10", }, { "name": "citizens", "count": "5", }, ] } </code></pre></div><h3 id="table-name"><a href="#table-name" class="header-anchor">#</a> table/{name} </h3> <p><a href="#authorization">권한 부여</a></p> <p><strong>GET</strong>/ 현재 생태계 요청 데이터 테이블에 대한 정보를 반환합니다.</p> <h4 id="-79"><a href="#-79" class="header-anchor">#</a> 요청</h4> <ul><li><p><em>[name]</em></p> <blockquote><p>데이터 테이블 이름입니다.</p></blockquote></li></ul> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/table/{table_name} </code></pre></div><p>다음과 같은 필드 정보를 반환합니다.</p> <ul><li><p><em>name</em></p> <blockquote><p>데이터 테이블 이름입니다.</p></blockquote></li> <li><p><em>insert</em></p> <blockquote><p>새 항목을 추가할 권한입니다.</p></blockquote></li> <li><p><em>new_column</em></p> <blockquote><p>필드를 추가할 권한입니다.</p></blockquote></li> <li><p><em>update</em></p> <blockquote><p>항목을 변경할 권한입니다.</p></blockquote></li> <li><p><em>columns</em></p> <blockquote><p>필드에 관련된 정보의 배열입니다.</p> <blockquote><ul><li><em>name</em></li></ul> <blockquote><p>필드 이름입니다.</p></blockquote> <ul><li><em>type</em></li></ul> <blockquote><p>필드 데이터 유형입니다.</p></blockquote> <ul><li><em>perm</em></li></ul> <blockquote><p>필드 값의 변경 권한입니다.</p></blockquote></blockquote></blockquote></li></ul> <h3 id="list-name-limit-offset-columns"><a href="#list-name-limit-offset-columns" class="header-anchor">#</a> list/{name}[?limit=... &offset=... &columns=... ] </h3> <p><a href="#authorization">권한 부여</a></p> <p><strong>GET</strong>/ 현재 생태계에서 지정된 데이터 테이블 항목의 목록을 반환합니다. 오프셋과 항목 수를 설정할 수 있습니다.</p> <h4 id="-80"><a href="#-80" class="header-anchor">#</a> 요청</h4> <ul><li><p><em>name</em></p> <blockquote><p>데이터 테이블 이름입니다.</p></blockquote></li> <li><p><em>[limit]</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p>항목 수입니다. 기본값은 25개 항목입니다.</p></blockquote></li> <li><p><em>[offset]</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p>오프셋입니다. 기본값은 0입니다.</p></blockquote></li> <li><p><em>[columns]</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p>요청한 열의 쉼표로 구분된 목록입니다. 지정되지 않은 경우 모든 열이 반환됩니다. id 열은 모든 경우에 반환됩니다.</p></blockquote></li></ul> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/list/mytable?columns=name </code></pre></div><h4 id="-81"><a href="#-81" class="header-anchor">#</a> 응답</h4> <ul><li><p><em>count</em></p> <blockquote><p>항목의 총 개수입니다.</p></blockquote></li> <li><p><em>list</em></p> <blockquote><p>배열의 각 요소는 다음 매개변수를 포함합니다.</p> <blockquote><ul><li><em>id</em></li></ul> <blockquote><p>항목 ID입니다.</p></blockquote> <ul><li>요청 열의 순서입니다.</li></ul></blockquote></blockquote></li></ul> <h4 id="-82"><a href="#-82" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "count": "10" "list": [{ "id": "1", "name": "John", }, { "id": "2", "name": "Mark", }, ] } </code></pre></div><h3 id="sections-limit-offset-lang"><a href="#sections-limit-offset-lang" class="header-anchor">#</a> sections[?limit=... &offset=... &lang=] </h3> <p><a href="#authorization">권한 부여</a></p> <p><strong>GET</strong>/ 현재 생태계의 <em>sections</em>를 반환합니다. 테이블 항목의 목록을 가져올 수 있으며, 오프셋과 항목의 개수를 설정할 수 있습니다.</p> <p><em>role_access</em> 필드에는 역할 목록이 포함되어 있고 현재 역할이 포함되지 않은 경우 레코드가 반환되지 않습니다.</p> <p><em>title</em> 필드의 데이터는 요청 헤더의 <em>Accept-Language</em> 언어 리소스로 대체됩니다.</p> <h4 id="-83"><a href="#-83" class="header-anchor">#</a> 요청 예시</h4> <ul><li><p><em>[limit]</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p>항목의 개수, 기본값은 25개입니다.</p></blockquote></li> <li><p><em>[offset]</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p>O오프셋, 기본값은 0입니다.</p></blockquote></li> <li><p><em>[lang]</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p>이 필드는 다국어 리소스 코드 또는 로캘을 지정합니다. 예를 들어 en, kr입니다. 지정된 다국어 리소스를 찾을 수 없는 경우, 예를 들어 en-US인 경우 en으로 다국어 리소스 그룹에서 검색합니다. <em>en</em> 에서 검색하세요.</p></blockquote></li></ul> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/sections </code></pre></div><h4 id="-84"><a href="#-84" class="header-anchor">#</a> 응답</h4> <ul><li><p><em>count</em></p> <blockquote><p><em>sections</em> 테이블 항목의 총 개수.</p></blockquote></li> <li><p><em>list</em></p> <blockquote><p>배열의 각 요소에는 actions 테이블의 모든 열에 대한 정보가 포함됩니다.</p></blockquote></li></ul> <h4 id="-85"><a href="#-85" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "count": "2" "list": [{ "id": "1", "title": "Development", "urlpage": "develop", ... }, ] } </code></pre></div><h4 id="-86"><a href="#-86" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_TABLENOTFOUND</em></p> <h3 id="row-name-id-columns"><a href="#row-name-id-columns" class="header-anchor">#</a> row/{name}/{id}[?columns=] </h3> <p><a href="#authorization">권한 부여</a></p> <p><strong>GET</strong>/ 현재 생태계에서 지정된 데이터 테이블의 항목을 반환합니다. 반환할 열을 지정할 수 있습니다.</p> <h4 id="-87"><a href="#-87" class="header-anchor">#</a> 요청</h4> <ul><li><p><em>name</em></p> <blockquote><p>데이터 테이블 이름.</p></blockquote></li> <li><p><em>id</em></p> <blockquote><p>항목 ID.</p></blockquote></li> <li><p><em>[columns]</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p>요청된 열의 쉼표로 구분된 목록입니다. 지정하지 않은 경우 모든 열이 반환됩니다. id 열은 모든 경우에 반환됩니다.</p></blockquote></li></ul> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/row/mytable/10?columns=name </code></pre></div><h4 id="-88"><a href="#-88" class="header-anchor">#</a> 응답</h4> <ul><li><p><em>value</em></p> <blockquote><p>받은 열 값의 배열</p> <blockquote><ul><li><em>id</em></li></ul> <blockquote><p>엔트리 ID.</p></blockquote> <ul><li>요청된 열의 순서.</li></ul></blockquote></blockquote></li></ul> <h4 id="-89"><a href="#-89" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "values": { "id": "10", "name": "John", } } </code></pre></div><h4 id="-90"><a href="#-90" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_NOTFOUND</em></p> <h3 id="row-name-colorn-id"><a href="#row-name-colorn-id" class="header-anchor">#</a> row/{name}/{column}/{id} </h3> <p>[Authorization] (#authorization)</p> <p><strong>GET</strong>/ 현재 생태계에서 지정된 데이터 테이블의 항목을 반환합니다. 반환할 열을 지정할 수 있습니다.</p> <h4 id="-91"><a href="#-91" class="header-anchor">#</a> 요청</h4> <ul><li><p><em>Name</em></p> <blockquote><p>데이터 테이블 이름.</p></blockquote></li> <li><p><em>colorn</em></p> <blockquote><p>데이터 목록 이름.</p></blockquote></li> <li><p><em>ID</em></p> <blockquote><p>스트라이프 ID.</p></blockquote></li> <li><p><em>[columns]</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p>쉼표로 구분된 요청 열의 목록입니다. 지정하지 않으면 모든 열이 반환됩니다. ID 열은 모든 경우에 반환됩니다.</p></blockquote></li></ul> <p>`` `default GET /api/v2/row/mytable/name/John?columns=name</p> <div class="language- extra-class"><pre class="language-text"><code> #### 응답 - *Value* > 수신한 열 값의 배열 > > > - *ID* > > > > > 스트립 ID. > > > > - 요청 열의 순서. #### 응답 예시 ```text 200 (OK) Content-Type: application/json { "values": { "id": "10", "name": "John", } } </code></pre></div><h4 id="-92"><a href="#-92" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_NOTFOUND</em></p> <h3 id="systemparams"><a href="#systemparams" class="header-anchor">#</a> systemparams </h3> <p><a href="#authorization">권한 부여</a></p> <p><strong>GET</strong>/ 플랫폼 매개변수 목록을 반환합니다.</p> <h4 id="-93"><a href="#-93" class="header-anchor">#</a> 요청 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/systemparams/[?names=...] </code></pre></div><ul><li><p><em>[names]</em> <a href="#omitempty">Omitempty</a></p> <p>쉼표로 구분된 요청 매개변수의 목록입니다. 예를 들어 <code>/api/v2/systemparams/?names=max_columns,max_indexes</code>입니다.</p></li></ul> <h4 id="-94"><a href="#-94" class="header-anchor">#</a> 응답</h4> <ul><li><p><em>list</em></p> <blockquote><p>배열의 각 요소는 다음 매개변수를 포함합니다.</p> <blockquote><ul><li><em>name</em></li></ul> <blockquote><p>매개변수 이름입니다.</p></blockquote> <ul><li><em>value</em></li></ul> <blockquote><p>매개변수 값입니다.</p></blockquote> <ul><li><em>conditions</em></li></ul> <blockquote><p>매개변수의 권한을 변경합니다.</p></blockquote></blockquote></blockquote></li></ul> <h4 id="-95"><a href="#-95" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "list": [{ "name": "max_columns", "value": "100", "conditions": "ContractAccess("@1UpdateSysParam")", }, { "name": "max_indexes", "value": "1", "conditions": "ContractAccess("@1UpdateSysParam")", }, ] } </code></pre></div><h4 id="-96"><a href="#-96" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_PARAMNOTFOUND</em></p> <h3 id="history-name-id"><a href="#history-name-id" class="header-anchor">#</a> history/{name}/{id} </h3> <p><a href="#authorization">권한 부여</a></p> <p><strong>GET</strong>/ 현재 생태계에서 지정된 데이터 테이블의 항목에 대한 변경 기록을 반환합니다.</p> <h4 id="-97"><a href="#-97" class="header-anchor">#</a> 요청 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/history?name=contracts&id=5 </code></pre></div><blockquote><ul><li><p><em>name</em></p> <p>데이터 테이블 이름입니다.</p></li> <li><p><em>id</em></p> <p>엔트리 ID입니다.</p></li></ul></blockquote> <h4 id="-98"><a href="#-98" class="header-anchor">#</a> 응답</h4> <blockquote><ul><li><p><em>list</em></p> <p>배열의 각 요소는 요청된 엔트리의 변경 기록을 포함합니다.</p></li></ul></blockquote> <h4 id="-99"><a href="#-99" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "list": [ { "name": "default_page", "value": "P(class, Default Ecosystem Page)" }, { "menu": "default_menu" } ] } </code></pre></div><h3 id="interface-page-menu-snippet-name"><a href="#interface-page-menu-snippet-name" class="header-anchor">#</a> interface/{page|menu|snippet}/{name} </h3> <p><a href="#authorization">권한 부여</a></p> <p><strong>GET</strong>/ 지정된 데이터 테이블(페이지, 메뉴 또는 스니펫)의 현재 생태계를 반환합니다. <em>이름</em> 필드에 대한 항목입니다.</p> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/interface/page/default_page /api/v2/interface/menu/default_menu /api/v2/interface/snippet/welcome </code></pre></div><h4 id="-100"><a href="#-100" class="header-anchor">#</a> 요청 예시</h4> <ul><li><p><em>name</em></p> <blockquote><p>테이블의 항목 이름을 지정합니다.</p></blockquote></li></ul> <h4 id="-101"><a href="#-101" class="header-anchor">#</a> 응답</h4> <ul><li><p><em>id</em></p> <blockquote><p>항목 ID입니다.</p></blockquote></li> <li><p><em>name</em></p> <blockquote><p>항목 이름입니다.</p></blockquote></li> <li><p><em>other</em></p> <blockquote><p>테이블의 다른 열들입니다.</p></blockquote></li></ul> <h4 id="-102"><a href="#-102" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "id": "1", "name": "default_page", "value": "P(Page content)", "default_menu": "default_menu", "validate_count": 1 } </code></pre></div><h4 id="-103"><a href="#-103" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_QUERY</em>, <em>E_NOTFOUND</em></p> <h2 id="contract-function-interface"><a href="#contract-function-interface" class="header-anchor">#</a> 계약 함수 인터페이스 </h2> <h3 id="contracts-limit-offset"><a href="#contracts-limit-offset" class="header-anchor">#</a> contracts[?limit=... &offset=... ] </h3> <p><a href="#authorization">권한 부여</a></p> <p><strong>GET</strong>/ 오프셋 및 항목 수를 설정할 수 있는 기능과 함께 현재 생태계의 계약 목록을 반환합니다.</p> <h4 id="-104"><a href="#-104" class="header-anchor">#</a> 요청 예시</h4> <ul><li><p><em>[limit]</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p>항목 개수입니다. 기본값은 25개입니다.</p></blockquote></li> <li><p><em>[offset]</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p>오프셋입니다. 기본값은 0입니다.</p></blockquote></li></ul> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/contracts </code></pre></div><h4 id="-105"><a href="#-105" class="header-anchor">#</a> 응답</h4> <ul><li><p><em>count</em></p> <blockquote><p>항목의 총 개수입니다.</p></blockquote></li> <li><p><em>list</em></p> <blockquote><p>배열의 각 요소는 다음과 같은 매개변수를 포함합니다.</p> <blockquote><ul><li><em>id</em></li></ul> <blockquote><p>계약 ID입니다.</p></blockquote> <ul><li><em>name</em></li></ul> <blockquote><p>계약 이름입니다.</p></blockquote> <ul><li><em>value</em></li></ul> <blockquote><p>계약 내용입니다.</p></blockquote> <ul><li><em>wallet_id</em></li></ul> <blockquote><p>계약과 연결된 계정 주소입니다.</p></blockquote> <ul><li><em>address</em></li></ul> <blockquote><p>계약과 연결된 지갑 주소 <code>XXXX-...-XXXX</code>입니다.</p></blockquote> <ul><li><em>ecosystem_id</em></li></ul> <blockquote><p>계약이 속한 생태계 ID입니다.</p></blockquote> <ul><li><em>app_id</em></li></ul> <blockquote><p>계약이 속한 애플리케이션 ID입니다.</p></blockquote> <ul><li><em>conditions</em></li></ul> <blockquote><p>계약의 권한을 변경합니다.</p></blockquote> <ul><li><em>token_id</em></li></ul> <blockquote><p>계약 수수료를 지불하는 데 사용되는 패스가 속한 생태계의 ID입니다.</p></blockquote></blockquote></blockquote></li></ul> <h4 id="-106"><a href="#-106" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "count": "10" "list": [{ "id": "1", "name": "MainCondition", "token_id": "1", "wallet_id": "0", "value": "contract MainCondition { conditions { if(EcosysParam(`founder_account`)!=$key_id) { warning `Sorry, you dont have access to this action.` } } }", "address":"0000-0000-0000-0000-0000", "conditions":"ContractConditions(`MainCondition`)" }, ... ] } </code></pre></div><h3 id="contract-name"><a href="#contract-name" class="header-anchor">#</a> contract/{name} </h3> <p><a href="#authorization">권한 부여</a></p> <p><strong>GET</strong>/ 지정된 계약에 대한 정보를 반환합니다. 기본값은 현재 생태계에서 계약을 쿼리하는 것입니다.</p> <h4 id="-107"><a href="#-107" class="header-anchor">#</a> 요청 예시</h4> <ul><li><p><em>name</em></p> <blockquote><p>계약 이름.</p></blockquote></li></ul> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/contract/mycontract </code></pre></div><h4 id="-108"><a href="#-108" class="header-anchor">#</a> 응답</h4> <ul><li><p><em>id</em></p> <blockquote><p>VM에서의 계약 ID.</p></blockquote></li> <li><p><em>name</em></p> <blockquote><p>생태계 ID <code>@1MainCondition</code>와 함께 사용되는 계약 이름.</p></blockquote></li> <li><p><em>state</em></p> <blockquote><p>계약의 생태계 ID.</p></blockquote></li> <li><p><em>walletid</em></p> <blockquote><p>계약이 연결된 계정의 주소.</p></blockquote></li> <li><p><em>tokenid</em></p> <blockquote><p>계약 비용으로 사용되는 패스의 생태계 ID.</p></blockquote></li> <li><p><em>address</em></p> <blockquote><p>계약에 바인딩 된 지갑 주소 <code>XXXX-...-XXXX</code>.</p></blockquote></li> <li><p><em>tableid</em></p> <blockquote><p>계약이 위치한 <em>contracts</em> 테이블의 항목 ID.</p></blockquote></li> <li><p><em>fields</em></p> <blockquote><p>이 배열은 계약 <strong>데이터</strong> 섹션의 각 매개 변수의 구조 정보를 포함합니다.</p> <blockquote><ul><li><em>name</em></li></ul> <blockquote><p>매개 변수 이름입니다.</p></blockquote> <ul><li><em>type</em></li></ul> <blockquote><p>매개 변수 유형입니다.</p></blockquote> <ul><li><em>optional</em></li></ul> <blockquote><p>매개 변수 옵션입니다. `true`는 선택적 매개 변수를 의미하고, `false`는 필수 매개 변수를 의미합니다.</p></blockquote></blockquote></blockquote></li></ul> <h4 id="-109"><a href="#-109" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "fields" : [ {"name": "amount", "type": "int", "optional": false}, {"name": "name", "type": "string", "optional": true} ], "id": 150, "name":"@1mycontract", "tableid" : 10, } </code></pre></div><h4 id="-110"><a href="#-110" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_CONTRACT</em></p> <h3 id="sendtx"><a href="#sendtx" class="header-anchor">#</a> sendTX </h3> <p><a href="#authorization">권한 부여</a></p> <p><strong>POST</strong>/ 매개변수의 트랜잭션을 수신하고 트랜잭션 대기열에 추가하고 요청이 성공적으로 실행되면 트랜잭션 해시를 반환합니다. 이 해시는 블록 내에서 해당 트랜잭션을 생성하며 오류 응답의 경우 오류 텍스트 메시지에 포함됩니다.</p> <h4 id="-111"><a href="#-111" class="header-anchor">#</a> 요청 예시</h4> <ul><li><p><em>tx_key</em></p> <blockquote><p>거래 내용, 이 매개 변수는 임의의 이름을 지정할 수 있으며 여러 거래를 받을 수 있습니다.</p></blockquote></li></ul> <div class="language-text extra-class"><pre class="language-text"><code>POST /api/v2/sendTx Headers: Content-Type: multipart/form-data Parameters: tx1 - Transaction 1 txN - Trading N </code></pre></div><h4 id="-112"><a href="#-112" class="header-anchor">#</a> 응답</h4> <ul><li><p><em>hashes</em></p> <blockquote><p>거래 해시 배열.</p> <blockquote><ul><li><em>tx1</em></li></ul> <blockquote><p>거래 1의 해시.</p></blockquote> <ul><li><em>txN</em></li></ul> <blockquote><p>거래 N의 해시.</p></blockquote></blockquote></blockquote></li></ul> <h4 id="-113"><a href="#-113" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "hashes": { "tx1": "67afbc435634..... ", "txN": "89ce4498eaf7..... ", } </code></pre></div><h4 id="-114"><a href="#-114" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_LIMITTXSIZE</em>,<em>E_BANNED</em></p> <h3 id="txstatus"><a href="#txstatus" class="header-anchor">#</a> txstatus </h3> <p><a href="#authorization">권한 부여</a></p> <p><strong>POST</strong>/ 지정된 트랜잭션 해시에 대한 블록 ID와 오류 메시지를 반환합니다. 블록 ID와 오류 텍스트 메시지의 반환 값이 null이면 해당 트랜잭션이 아직 블록에 포함되지 않았습니다.</p> <h4 id="-115"><a href="#-115" class="header-anchor">#</a> 요청 예시</h4> <ul><li><p><em>data</em></p> <blockquote><p>트랜잭션 해시의 JSON 목록입니다.</p></blockquote></li></ul> <div class="language-text extra-class"><pre class="language-text"><code>{"hashes":["contract1hash", "contract2hash", "contract3hash"]} </code></pre></div><div class="language-text extra-class"><pre class="language-text"><code>POST /api/v2/txstatus/ </code></pre></div><h4 id="-116"><a href="#-116" class="header-anchor">#</a> 응답</h4> <ul><li><p><em>results</em></p> <blockquote><p>데이터 사전에서 트랜잭션 해시를 키로 사용하고 트랜잭션 세부 정보를 값으로 사용합니다.</p> <ul><li><p><em>hash</em></p> <blockquote><p>트랜잭션 해시.</p> <ul><li><p><em>blockid</em></p> <blockquote><p>트랜잭션 실행이 성공하면 블록 ID가 반환됩니다. 트랜잭션 실행이 실패하면 [0]{.title-ref}의 <em>blockid</em>가 반환됩니다.</p></blockquote></li> <li><p><em>result</em></p> <blockquote><p><strong>$result</strong> 변수를 통해 트랜잭션 결과를 반환합니다.</p></blockquote></li> <li><p><em>errmsg</em></p> <blockquote><p>트랜잭션 실행이 실패하면 오류 텍스트 메시지를 반환합니다.</p></blockquote></li></ul></blockquote></li></ul></blockquote></li></ul> <h4 id="-117"><a href="#-117" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "results": { "hash1": { "blockid": "3123", "result": "", }, "hash2": { "blockid": "3124", "result": "", } } } </code></pre></div><h4 id="-118"><a href="#-118" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_HASHWRONG, E_HASHNOTFOUND</em></p> <h3 id="txinfo-hash"><a href="#txinfo-hash" class="header-anchor">#</a> txinfo/{hash} </h3> <p>이 요청에는 로그인 인증이 필요하지 않습니다.</p> <p><strong>얻다</strong>/</p> <p>블록 ID 및 확인 횟수를 포함하여 지정된 해시에 대한 트랜잭션에 대한 정보를 반환합니다. 선택적 매개변수가 지정된 경우 계약 이름 및 관련 매개변수도 반환합니다.</p> <h4 id="-119"><a href="#-119" class="header-anchor">#</a> 요청 예시</h4> <ul><li><p><em>hash</em></p> <blockquote><p>트랜잭션 해시.</p></blockquote></li> <li><p><em>[contractinfo]</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p>계약 세부 정보 매개 변수 식별자입니다. 이 트랜잭션과 관련된 계약 세부 정보를 얻으려면 <code>contractinfo=1</code>을 지정합니다.</p></blockquote></li></ul> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/txinfo/c7ef367b494c7ce855f09aa3f1f2af7402535ea627fa615ebd63d437db5d0c8a?contractinfo=1 </code></pre></div><h4 id="-120"><a href="#-120" class="header-anchor">#</a> 응답</h4> <ul><li><p><em>blockid</em></p> <blockquote><p>값이 <code>0</code>인 경우 해당 해시에 대한 트랜잭션이 발견되지 않았습니다.</p></blockquote></li> <li><p><em>confirm</em></p> <blockquote><p>이 <em>blockid</em>에 대한 확인 수.</p></blockquote></li> <li><p><em>data</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p><code>contentinfo=1</code>이 지정된 경우 계약 세부 정보가 이 매개 변수로 반환됩니다.</p></blockquote></li></ul> <h4 id="-121"><a href="#-121" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "blockid": "9", "confirm": 11, "data": { "block": "9", "contract": "@1NewContract", "params": { "ApplicationId": 1, "Conditions": "true", "Value": "contract crashci4b {\n\t\t\tdata {}\n\t\t\t}" } } } </code></pre></div><h4 id="-122"><a href="#-122" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_HASHWRONG</em></p> <h3 id="txinfomultiple"><a href="#txinfomultiple" class="header-anchor">#</a> txinfoMultiple </h3> <p>이 요청에는 로그인 인증이 필요하지 않습니다.</p> <p><strong>GET</strong>/</p> <p>지정된 해시에 대한 트랜잭션 관련 정보를 반환합니다.</p> <h4 id="-123"><a href="#-123" class="header-anchor">#</a> 요청 예시</h4> <ul><li><p><em>data</em></p> <ul><li><em>hashes</em> <blockquote><p>트랜잭션 해시의 목록입니다.</p></blockquote></li></ul></li> <li><p><em>[contractinfo]</em> <a href="#omitempty">Omitempty</a></p> <blockquote><p>계약 세부 정보와 관련된 계약 세부 정보 매개 변수 식별자입니다. 계약 세부 정보를 가져오려면 <code>contractinfo=1</code>을 지정합니다.</p></blockquote></li></ul> <div class="language-text extra-class"><pre class="language-text"><code>data: {"hashes":["contract1hash", "contract2hash", "contract3hash"]} </code></pre></div><div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/txinfoMultiple </code></pre></div><h4 id="-124"><a href="#-124" class="header-anchor">#</a> 응답</h4> <ul><li><p><em>results</em></p> <blockquote><p>트랜잭션 해시는 데이터 사전에서 키로 사용되며 트랜잭션 세부 정보는 값으로 사용됩니다.</p> <blockquote><p><em>hash</em></p> <blockquote><p>거래 해시입니다.</p></blockquote> <blockquote><p><em>blockid</em></p></blockquote> <p>값이 <code>0</code>이면 해당 해시에 대한 트랜잭션이 발견되지 않았습니다.</p> <blockquote><p><em>confirm</em></p></blockquote> <blockquote><p>이 블록 <em>blockid</em>에 대한 인정 횟수입니다.</p></blockquote> <blockquote><p><em>data</em></p></blockquote> <blockquote><p><code>contentinfo=1</code>이 지정된 경우, 계약 세부 정보가 이 매개 변수로 반환됩니다.</p></blockquote></blockquote></blockquote></li></ul> <h4 id="-125"><a href="#-125" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "results": { "hash1": { "blockid": "3123", "confirm": "5", }, "hash2": { "blockid": "3124", "confirm": "3", } } } </code></pre></div><h4 id="-126"><a href="#-126" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_HASHWRONG</em></p> <h3 id="page-validators-count-name"><a href="#page-validators-count-name" class="header-anchor">#</a> /page/validators_count/{name} </h3> <p>이 요청에는 로그인 인증이 필요하지 않습니다.</p> <p><strong>GET</strong>/ 지정된 페이지에 대해 확인할 노드 수를 반환합니다.</p> <h4 id="-127"><a href="#-127" class="header-anchor">#</a> 요청</h4> <ul><li><p><em>name</em></p> <blockquote><p>페이지 이름은 <code>@ecosystem_id%%page_name%</code> 형식으로 지정하며, 예를 들어 <code>@1main_page</code>입니다. 생태계 ID가 없는 경우, 기본적으로 첫 번째 생태계 페이지에서 검색합니다.</p></blockquote></li></ul> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/page/validators_count/@2page_name </code></pre></div><h4 id="-128"><a href="#-128" class="header-anchor">#</a> 응답</h4> <ul><li><p><em>validate_count</em></p> <blockquote><p>페이지에 대해 확인할 노드 수를 지정합니다.</p></blockquote></li></ul> <h4 id="-129"><a href="#-129" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json {"validate_count":1} </code></pre></div><h4 id="-130"><a href="#-130" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_NOTFOUND, E_SERVER</em></p> <h3 id="content-menu-page-name"><a href="#content-menu-page-name" class="header-anchor">#</a> content/menu|page/{name} </h3> <p><a href="#authorization">권한 부여</a></p> <p><strong>POST</strong></p> <p>템플릿 엔진에서 처리한 결과인 지정된 페이지 또는 메뉴 이름에 대한 코드 JSON 객체 트리를 반환합니다.</p> <h4 id="-131"><a href="#-131" class="header-anchor">#</a> 요청 예시</h4> <ul><li><p><em>name</em></p> <blockquote><p>페이지 이름 또는 메뉴 이름입니다. 형식은 <code>@ecosystem_id%%page_name%</code>이며 예를 들어 <code>@1main_page</code>입니다. 생태계 ID가 포함되지 않은 경우 기본적으로 현재 생태계의 페이지 또는 메뉴를 검색합니다.</p></blockquote></li></ul> <div class="language-text extra-class"><pre class="language-text"><code>POST /api/v2/content/page/default </code></pre></div><h4 id="-132"><a href="#-132" class="header-anchor">#</a> 응답</h4> <ul><li><p><em>menu</em> 또는 <em>title</em></p> <blockquote><p>요청 시 <em>content/page/...</em> 해당 페이지가 속한 메뉴의 이름입니다.</p></blockquote></li> <li><p><em>menutree</em></p> <blockquote><p>요청 시 <em>content/page/...</em> 페이지의 메뉴 JSON 객체 트리입니다.</p></blockquote></li> <li><p><em>title</em> -- *content/menu/...*의 메뉴 <em>head</em>에 대한 제목입니다.</p> <blockquote><p>요청 시 <em>content/menu/...</em> 메뉴 제목입니다.</p></blockquote></li> <li><p><em>tree</em></p> <blockquote><p>페이지 또는 메뉴의 JSON 객체 트리입니다.</p></blockquote></li></ul> <h4 id="-133"><a href="#-133" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "tree": {"type":"......" , "children": [ {...} , {...} ] }, } </code></pre></div><h4 id="-134"><a href="#-134" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_NOTFOUND</em></p> <h3 id="content-source-name"><a href="#content-source-name" class="header-anchor">#</a> content/source/{name} </h3> <p><a href="#authorization">권한 부여</a></p> <p><strong>POST</strong></p> <p>지정된 페이지 이름에 대한 코딩된 JSON 개체의 트리를 반환합니다. 기능을 실행하거나 데이터를 수신하지 않습니다. 반환된 JSON 개체 트리는 페이지 템플릿에 해당하며 시각적 페이지 디자이너에서 사용할 수 있습니다. 페이지를 찾을 수 없으면 404 오류가 반환됩니다. 요구 """""""</p> <ul><li><p><em>name</em></p> <blockquote><p>페이지 이름입니다. 생태계 ID를 포함하여 <code>@ecosystem_id%%page_name%</code> 형식으로 지정합니다. 예를 들어, <code>@1main_page</code>입니다. 생태계 ID가 포함되어 있지 않으면, 기본적으로 현재 페이지를 찾습니다.</p></blockquote></li></ul> <h4 id="-135"><a href="#-135" class="header-anchor">#</a> 응답</h4> <div class="language-text extra-class"><pre class="language-text"><code>POST /api/v2/content/source/default </code></pre></div><ul><li><p><em>tree</em></p> <blockquote><p>페이지의 JSON 개체 트리입니다.</p></blockquote></li></ul> <h4 id="-136"><a href="#-136" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "tree": {"type":"......" , "children": [ {...} , {...} ] }, } </code></pre></div><h4 id="-137"><a href="#-137" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_NOTFOUND, E_SERVER</em></p> <h3 id="content-hash-name"><a href="#content-hash-name" class="header-anchor">#</a> content/hash/{name} </h3> <p><strong>POST</strong></p> <p>지정된 페이지 이름의 SHA256 해시를 반환하거나, 페이지를 찾을 수 없는 경우 404 오류를 반환합니다.</p> <p>이 요청은 로그인 인증을 필요로하지 않습니다. 다른 노드에 요청을 보낼 때 올바른 해시를 받으려면 <em>ecosystem, keyID, roleID, isMobile</em> 매개변수도 전달해야합니다. 다른 생태계에서 페이지를 받으려면 페이지 이름 앞에 생태계 ID를 접두어로 사용해야합니다. 예를 들어: <code>@2mypage</code>.</p> <h4 id="-138"><a href="#-138" class="header-anchor">#</a> 요청 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>POST /api/v2/content/hash/default </code></pre></div><ul><li><p><em>name</em></p> <blockquote><p>생태계 ID가 포함된 페이지 이름.</p></blockquote></li> <li><p><em>ecosystem</em></p> <blockquote><p>생태계 ID.</p></blockquote></li> <li><p><em>keyID</em></p> <blockquote><p>계정 주소.</p></blockquote></li> <li><p><em>roleID</em></p> <blockquote><p>역할 ID.</p></blockquote></li> <li><p><em>isMobile</em></p> <blockquote><p>모바일 플랫폼의 매개 변수 식별.</p></blockquote></li></ul> <h4 id="-139"><a href="#-139" class="header-anchor">#</a> 응답</h4> <ul><li><p><em>hash</em></p> <blockquote><p>16진수 해시.</p></blockquote></li></ul> <h4 id="-140"><a href="#-140" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "hash": "b631b8c28761b5bf03c2cfbc2b49e4b6ade5a1c7e2f5b72a6323e50eae2a33c6" } </code></pre></div><h4 id="-141"><a href="#-141" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_NOTFOUND, E_SERVER, E_HEAVYPAGE</em></p> <h3 id="content"><a href="#content" class="header-anchor">#</a> content </h3> <p><strong>POST</strong></p> <p><strong>template</strong> 매개 변수에서 페이지 코드의 JSON 개체 수를 반환합니다. 선택적 매개 변수 <strong>source</strong>를 <code>true 또는 1</code>로 지정한 경우 이 JSON 개체 트리는 기능을 수행하지 않고 데이터를 수신하지 않습니다. 이 JSON 개체 트리는 시각적 페이지 디자이너에서 사용할 수 있습니다.</p> <p>이 요청은 로그인 인증이 필요하지 않습니다.</p> <h4 id="-142"><a href="#-142" class="header-anchor">#</a> 요청</h4> <ul><li><p><em>template</em></p> <blockquote><p>페이지 코드입니다.</p></blockquote></li> <li><p><em>[source]</em></p> <blockquote><p><code>true 또는 1</code>로 지정한 경우 JSON 개체 트리는 기능을 수행하지 않고 데이터를 수신하지 않습니다.</p></blockquote></li></ul> <div class="language-text extra-class"><pre class="language-text"><code>POST /api/v2/content </code></pre></div><h4 id="-143"><a href="#-143" class="header-anchor">#</a> 응답</h4> <ul><li><p><em>tree</em></p> <blockquote><p>JSON 객체 트리.</p></blockquote></li></ul> <h4 id="-144"><a href="#-144" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "tree": {"type":"......" , "children": [ {...} , {...} ] }, } </code></pre></div><h4 id="-145"><a href="#-145" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_NOTFOUND, E_SERVER</em></p> <h3 id="maxblockid"><a href="#maxblockid" class="header-anchor">#</a> maxblockid </h3> <p><strong>GET</strong>/ 현재 노드에서 가장 높은 블록 ID를 반환합니다.</p> <p>이 요청에는 로그인 인증이 필요하지 않습니다.</p> <h4 id="-146"><a href="#-146" class="header-anchor">#</a> 요청 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/maxblockid </code></pre></div><h4 id="-147"><a href="#-147" class="header-anchor">#</a> 응답</h4> <ul><li><p><em>max_block_id</em></p> <blockquote><p>현재 노드에서 가장 높은 블록 ID입니다.</p></blockquote></li></ul> <h4 id="-148"><a href="#-148" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "max_block_id" : 341, } </code></pre></div><h4 id="-149"><a href="#-149" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_NOTFOUND</em></p> <h3 id="block-id"><a href="#block-id" class="header-anchor">#</a> block/{id} </h3> <p><strong>GET</strong>/ 지정된 블록 ID에 대한 정보를 반환합니다.</p> <p>이 요청에는 로그인 인증이 필요하지 않습니다.</p> <h4 id="-150"><a href="#-150" class="header-anchor">#</a> 요청 예시</h4> <ul><li><p><em>id</em></p> <blockquote><p>블록 ID.</p></blockquote></li></ul> <div class="language-text extra-class"><pre class="language-text"><code>POST /api/v2/block/32 </code></pre></div><h4 id="-151"><a href="#-151" class="header-anchor">#</a> 응답</h4> <ul><li><p><em>hash</em></p> <blockquote><p>블록 해시.</p></blockquote></li> <li><p><em>key_id</em></p> <blockquote><p>블록을 서명한 계정 주소.</p></blockquote></li> <li><p><em>time</em></p> <blockquote><p>블록 생성 타임스탬프.</p></blockquote></li> <li><p><em>tx_count</em></p> <blockquote><p>블록 내의 전체 거래 수.</p></blockquote></li> <li><p><em>rollbacks_hash</em></p> <blockquote><p>블록 롤백 해시.</p></blockquote></li> <li><p><em>node_position</em></p> <blockquote><p>영광 노드 목록에서의 블록 위치.</p></blockquote></li></ul> <h4 id="-152"><a href="#-152" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "hash": "1x4S5s/zNUTopP2YK43SppEyvT2O4DW5OHSpQfp5Tek=", "key_id": -118432674655542910, "time": 1551145365, "tx_count": 3, "rollbacks_hash": "47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU=", "node_position": 0, } </code></pre></div><h4 id="-153"><a href="#-153" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_NOTFOUND</em></p> <h3 id="avatar-ecosystem-member"><a href="#avatar-ecosystem-member" class="header-anchor">#</a> avatar/{ecosystem}/{member} </h3> <p><strong>GET</strong>/ <em>member</em> 테이블(로그인 없이 사용 가능)에서 사용자의 아바타를 반환합니다.</p> <h4 id="-154"><a href="#-154" class="header-anchor">#</a> 요청 예시</h4> <ul><li><p><em>ecosystem</em></p> <blockquote><p>생태계 ID.</p></blockquote></li> <li><p><em>member</em></p> <blockquote><p>사용자의 계정 주소. (xxxx-... -xxxx)</p></blockquote></li></ul> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/avatar/1/1234-2134-... -4321 </code></pre></div><h4 id="-155"><a href="#-155" class="header-anchor">#</a> 응답</h4> <p>요청 헤더 <em>Content-Type</em>은 이미지 유형이며 이미지 데이터는 응답 본문에 반환됩니다.</p> <h4 id="-156"><a href="#-156" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: image/png </code></pre></div><h4 id="-157"><a href="#-157" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_NOTFOUND</em> <em>E_SERVER</em></p> <h3 id="config-centrifugo"><a href="#config-centrifugo" class="header-anchor">#</a> config/centrifugo </h3> <p><strong>GET</strong>/ centrifugo의 호스트 주소와 포트를 반환합니다.</p> <p>이 요청에는 로그인 인증이 필요하지 않습니다.</p> <h4 id="-158"><a href="#-158" class="header-anchor">#</a> 요청 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>GET /api/v2/config/centrifugo </code></pre></div><h4 id="-159"><a href="#-159" class="header-anchor">#</a> 응답</h4> <p>응답 결과 형식 <code>http://address:port</code>, 예: <code>http://127.0.0.1:8100</code>.</p> <h4 id="-160"><a href="#-160" class="header-anchor">#</a> 에러 응답</h4> <p><em>E_SERVER</em></p> <h3 id="updnotificator"><a href="#updnotificator" class="header-anchor">#</a> updnotificator </h3> <p><strong>POST</strong>/</p> <p>(폐기)</p> <p>아직 전송되지 않은 모든 메시지를 centrifugo 알림 서비스로 전송합니다. 지정된 생태계 및 구성원에 대한 메시지만 보냅니다.</p> <p>이 요청에는 로그인 인증이 필요하지 않습니다.</p> <h4 id="-161"><a href="#-161" class="header-anchor">#</a> 요청 예시</h4> <ul><li><p><em>id</em></p> <blockquote><p>회원의 계정 주소.</p></blockquote></li> <li><p><em>ecosystem</em></p> <blockquote><p>생태계 ID.</p></blockquote></li></ul> <div class="language-text extra-class"><pre class="language-text"><code>POST /api/v2/updnotificator </code></pre></div><h4 id="-162"><a href="#-162" class="header-anchor">#</a> 응답 예시</h4> <div class="language-text extra-class"><pre class="language-text"><code>200 (OK) Content-Type: application/json { "result": true } </code></pre></div><h3 id="special-instructions"><a href="#special-instructions" class="header-anchor">#</a> 특별한 지시사항이 있으신가요? </h3> <h4 id="omitempty"><a href="#omitempty" class="header-anchor">#</a> 비어 있음 </h4> <p>Omitempty 속성이 있는 필드는 선택적인 매개변수를 의미합니다.</p> <h4 id="authorization"><a href="#authorization" class="header-anchor">#</a> 인증 </h4> <p>Authorization 태그가 있는 인터페이스는 로그인 인증이 필요한 인터페이스입니다. 요청 헤더에 Authorization을 추가해야 합니다. 예시:</p> <p>key = Authorization value = "Bearer + <a href="#login">login token</a>"</p> <div class="language-text extra-class"><pre class="language-text"><code>Authorization Bearer eyJhbGciOiJI..... kBZgGIlPhfXNZJ73RiZtM </code></pre></div></div> <footer class="page-edit"><div class="edit-link"><a href="https://github.com/IBAX-io/documentation/edit/master/docs/kr/reference/api2.md" target="_blank" rel="noopener noreferrer">GitHub에서 이 페이지 편집</a> <span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></div> <div class="last-updated"><span class="prefix">마지막 업데이트:</span> <span class="time">2023/7/4 11:08:51</span></div></footer> <div class="page-nav"><p class="inner"> <span class="next"><a href="/kr/reference/platform-parameters.html"> 플랫폼 매개변수 </a> → </span></p></div> </main></div><div class="global-ui"></div></div> <script src="/assets/js/app.d049f7ab.js" defer></script><script src="/assets/js/2.8d94a0db.js" defer></script><script src="/assets/js/111.05c79add.js" defer></script> </body> </html>