Skip to content
SangHyun Lee edited this page Nov 21, 2019 · 4 revisions

유의 사항

  • API는 User-Agent에 단말에서 생성한 고유한 값을 요구합니다. {PlatformDefault} {OS} {AppName}/{AppVersion} ({UUID}+{Random 8Byte Characters})
    • OS는 현재 단말의 Platform 이름 입니다.
    • AppName 및 AppVersion은 현재 API를 사용하는 App의 이름과 Version 이름입니다.
    • UUID는 임의로 생성한 UUID를 사용합니다.
    • Random 8Byte 문자열은 임의로 생성한 문자열을 사용합니다.
    • UUID+Random 문자열은 단말에서 저장하여 반복하여 사용합니다.
    • API Service에서는 사용자를 식별하는 값을 개인키에서 생성하는 값을 사용하지 않으므로(사용자 및 단말기 추적 로그를 생성하지 않음) API 서비스의 연속성을 위해 별도로 생성한 값(앱 인스턴스 추적)을 이용할 수 있습니다.(현재는 사용되지 않음)
  • API URL https://api.symverse.com

Scan

Tx 내역 스캔

POST https://{API_URL}/scan/gettransaction

Path

  • 없음

Parameters

  • 없음

Request Header

Key Type Value
content-type String application/json;charset=utf8
user-agent String {PlatformDefault} {OS} {AppName}/{AppVersion} ({UUID}+{Random 8Byte Characters})

Ex.
Mozilla/5.0 (Linux; Android 9; LM-G710N Build/PKQ1.181105.001; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/77.0.3865.92 Mobile Safari/537.36 Android SymWallet/0.0.1 (2c09b086-a1c0-469b-bc5b-ecc538c08fd0+zqq24hPc)

Payload

Key Type Value
check_token String API Sequence 통신시 사용
초기화 : 0000
pcmd String 0 : 가장 최근 것부터 pcnt의 개수 만큼 검색
D : pnumidx 부터 이전 것을 검색
U : pnumidx 부터 이후 것을 검색
pcnt String 요청할 개수
pnum String 검색을 시작할 아이템의 번호
pnumidx String 검색을 시작할 아이템의 Index
ptype String SymID의 보냄, 받음 기록을 가져옵니다.
A : All
T : To
F : From
SymID String 0x를 포함한 SymID
v_app_code String Application Version Code
v_app_os String AOS, IOS
v_app_version String Application Version Name
v_country_code String ISO 2글자 국가 코드
v_device_code String User-Agent에 추가한 {UUID}+{Random 8Byte Characters}
{
    "check_token": "",
    "pcmd": "0",
    "pcnt": "20",
    "pnum": "4099285",
    "pnumidx": "0",
    "ptype": "A",
    "SymID": "0x00025ba7bc8d9c870002",
    "v_app_code": "1",
    "v_app_os": "AOS",
    "v_app_version": "0.0.1",
    "v_country_code": "KR",
    "v_device_code": "2c09b086-a1c0-469b-bc5b-ecc538c08fd0+zqq24hPc"
}

Response Payload

Key Type Value
transactions Object Array
: blockHash Hex String 블록해시
: temp long 임시 BlockNumber
: transactionIndex Hex String Tx Index
: type Hex String Tx Type
: nonce Hex String Tx nonce
: workNodes String Array WorkNode SymID Array
: input Hex String Tx Input Data
: data_create Hex String Tx Timestamp
: blockNumber long BlockNumber
: from Hex String From(Sender)
: to Hex String To(Receiver)
: value Hex String Tx Send Amount
: gas Hex String Gas
: gasPrice Hex String Gas Price
: seq long Sequence
: hash Hex String Tx Hash
: v Hex String v
: r Hex String r
: s Hex String s
{
    "transactions": [
        {
            "blockHash": "0xa0ebd43a9b3853c76a2f846f12efb72945fd29b6834c891950338ce3363c6637",
            "temp": 4088521,
            "transactionIndex": "0x0",
            "type": "0x0",
            "nonce": "0x0",
            "workNodes": "[]",
            "input": "0x0",
            "r": "0x0",
            "s": "0x0",
            "date_create": "0x5d91a218",
            "v": "0x0",
            "blockNumber": 4088521,
            "gas": "0x0",
            "from": "0x00010000000000020002",
            "to": "0x00025ba7bc8d9c870002",
            "value": "0x1a675944a9a107b9",
            "seq": 1114366,
            "hash": "0x0",
            "gasPrice": "0x5d21dba00"
        },
         ...
    ]
}