Transaction API는 트랜잭션 전송, 조회 기능을 제공합니다.

트랜잭션 조회

트랜잭션 해시(txhash)를 지정하여 트랜잭션 정보를 조회합니다. 블록체인에 전송되어 블록에 기록된 트랜잭션만 조회할 수 있습니다.

Request URL

Live URL https://bc-api.qpyou.cn/core/v1/tx/{txhash}
Sandbox URL https://sandbox-bc-api.qpyou.cn/core/v1/tx/{txhash}
HTTP Method GET
Content-Type application/json

Path Parameters

필드명 설명 타입 필수 여부
txhash 트랜잭션 해시 string Y

Header Parameters

필드명 설명 타입 필수 여부
x-network 블록체인 네트워크{ploygon, xpla} string Y

Responses

필드명 설명 타입
code api 호출 결과 코드, 0:성공 number
message 결과 메시지 string
data API 응답 데이터 json
data.txhash 트랜잭션 해시 string
data.blockNumber 트랜잭션이 담긴 블록 넘버 number
data.status 트랜잭션 상태이며, 블록체인 블록에 트랜잭션이 성공적으로 기록 완료되면 success string
data.fee 사용된 수수료 json
data.data 트랜잭션 데이터

json
data.logs 트랜잭션 로그 json[]

Request Sample

Response Sample

트랜잭션 전송

서명한 트랜잭션을 블록체인에 전송합니다.

Request URL

Live URL https://bc-api.qpyou.cn/core/v1/tx
Sandbox URL https://sandbox-bc-api.qpyou.cn/core/v1/tx
HTTP Method POST
Content-Type application/json

Header Parameters

필드명 설명 타입 필수 여부
x-network 블록체인 네트워크{ploygon, xpla} string Y

Request Body

필드명 설명 타입 필수 여부
signedTx 서명한 트랜잭션 string Y
sync 트랜잭션 동기/비동기 처리 여부

  • true: 동기식 처리로 트랜잭션이 블록에 담길 때까지 대기합니다. API를 호출한 상태로 응답값(txHash)을 받을 때까지 대기합니다.
  • false: 비동기식 처리로 트랜잭션 전송 성공/실패를 바로 확인할 수 없습니다. 트랜잭션 조회 API를 호출해 트랜잭션 전송 성공 여부를 확인해야 합니다.
boolean Y

Responses

필드명 설명 타입
code api 호출 결과 코드, 0:성공 number
message 결과 메시지 string
data API 응답 데이터 json
data.txhash 트랜잭션 해시 string
data.status 트랜잭션 상태 string

Request Sample

Response Sample