Lock API는 NFT 토큰을 거래할 수 없도록 잠그거나 다시 거래할 수 있도록 잠금 해제하는 기능을 제공합니다.

잠금 컨트랙트 배포

잠금 컨트랙트를 배포하는 트랜잭션을 생성합니다. 잠금 컨트랙트는 지갑에 있는 NFT 토큰을 거래할 수 없도록 잠그거나 다시 거래할 수 있도록 잠금 해제하는 기능을 제공합니다.

Request URL

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

Header Parameters

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

Request Body

필드명 설명 타입 필수 여부
name 잠금 컨트랙트 이름 string Y
from 잠금 컨트랙트를 배포할 지갑 주소 string Y
encoded 반환받을 트랜잭션의 인코딩 여부

  • true: data.rawTx으로 인코딩된 Raw Transaction String을 받습니다.
  • false: data.rawTx으로 인코딩을 디코딩한 JSON 결과값을 받습니다.
boolean N

Responses

필드명 설명 타입
code api 호출 결과 코드, 0:성공 number
message 결과 메시지 string
data API 응답 데이터 json
data.rawTx 트랜잭션 데이터 string 또는 json
data.requestId API 요청을 식별할 수 있는 고유값 string

Request Sample

Response Sample

NFT 잠금

NFT 소유자 계정(from)이 NFT(tokenId)를 잠금 컨트랙트로 전송하는 트랜잭션을 생성합니다. NFT를 잠금 컨트랙트로 전송하면 이 NFT는 잠금 컨트랙트 소유가 되며 기존 소유자는 더는 이 토큰을 다른 계정으로 전송할 수 없습니다.

Request URL

Live URL https://bc-api.qpyou.cn/core/v1/nft/contract/{contract}/lock
Sandbox URL https://sandbox-bc-api.qpyou.cn/core/v1/nft/contract/{contract}/lock
HTTP Method POST
Content-Type application/json

Path Parameters

필드명 설명 타입 필수 여부
contract NFT 컨트랙트 주소 string Y

Header Parameters

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

Request Body

필드명 설명 타입 필수 여부
from NFT 소유자 지갑 주소 string Y
lockContract 잠금 컨트랙트 주소 string Y
tokenId NFT ID string Y
encoded 반환받을 트랜잭션의 인코딩 여부

  • true: data.rawTx으로 인코딩된 Raw Transaction String을 받습니다.
  • false: data.rawTx으로 인코딩을 디코딩한 JSON 결과값을 받습니다.
boolean N

Responses

필드명 설명 타입
code api 호출 결과 코드, 0:성공 number
message 결과 메시지 string
data API 응답 데이터 json
data.rawTx 트랜잭션 데이터 string 또는 json
data.requestId API 요청을 식별할 수 있는 고유값 string

Request Sample

Response Sample

NFT 잠금 해제

잠금 컨트랙트에 있는 NFT(tokenId)를 NFT 소유자 계정에게 전송하는 트랜잭션을 생성합니다. NFT를 NFT 소유자 계정으로 전송하면 소유자는 이 토큰을 다시 거래할 수 있습니다.

Request URL

Live URL https://bc-api.qpyou.cn/core/v1/lock/contract/{contract}/unlock
Sandbox URL https://sandbox-bc-api.qpyou.cn/core/v1/lock/contract/{contract}/unlock
HTTP Method POST
Content-Type application/json

Path Parameters

필드명 설명 타입 필수 여부
contract 잠금 컨트랙트 주소 string Y

Header Parameters

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

Request Body

필드명 설명 타입 필수 여부
nftContract NFT 컨트랙트 주소 string Y
lockContractOwner 잠금 컨트랙트를 배포한 계정(잠금 컨트랙트 소유자) 지갑 주소 string Y
tokenId NFT ID string Y
encoded 반환받을 트랜잭션의 인코딩 여부

  • true: data.rawTx으로 인코딩된 Raw Transaction String을 받습니다.
  • false: data.rawTx으로 인코딩을 디코딩한 JSON 결과값을 받습니다.
boolean N

Responses

필드명 설명 타입
code api 호출 결과 코드, 0:성공 number
message 결과 메시지 string
data API 응답 데이터 json
data.rawTx 트랜잭션 데이터 string 또는 json
data.requestId API 요청을 식별할 수 있는 고유값 string

Request Sample

Response Sample

잠금 설정한 NFT를 소유한 계정 조회

잠금 설정한 NFT(tokenId)의 소유자 계정을 조회합니다.

Request URL

Live URL https://bc-api.qpyou.cn/core/v1/lock/contract/{contract}/token/{tokenId}/account
Sandbox URL https://sandbox-bc-api.qpyou.cn/core/v1/lock/contract/{contract}/token/{tokenId}/account
HTTP Method GET
Content-Type application/json

Path Parameters

필드명 설명 타입 필수 여부
contract 잠금 컨트랙트 주소 string Y
tokenId NFT ID string Y

Header Parameters

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

Query Parameters

필드명 설명 타입 필수 여부
nftContract NFT 컨트랙트 주소 string Y

Responses

필드명 설명 타입
code api 호출 결과 코드, 0:성공 number
message 결과 메시지 string
data API 응답 데이터 json
data.owner NFT 소유자 계정 주소 string

Request Sample

Response Sample

잠금 설정한 NFT 조회

잠금 컨트랙트(contract) 주소에서 특정 소유자(owner)의 잠금 설정한 NFT를 조회합니다.

Request URL

Live URL https://bc-api.qpyou.cn/core/v1/lock/contract/{contract}/account/{owner}/tokens
Sandbox URL https://sandbox-bc-api.qpyou.cn/core/v1/lock/contract/{contract}/account/{owner}/tokens
HTTP Method GET
Content-Type application/json

Path Parameters

필드명 설명 타입 필수 여부
contract 잠금 컨트랙트 주소 string Y
owner NFT 소유자 주소 string Y

Header Parameters

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

Responses

필드명 설명 타입
code api 호출 결과 코드, 0:성공 number
message 결과 메시지 string
data API 응답 데이터 json
data.tokens 잠금 설정한 NFT 목록 array
data.tokens.owner NFT 소유자 지갑 주소 string
data.tokens.nftAddress NFT 컨트랙트 주소 string
data.tokens.tokenId NFT ID string

Request Sample

Response Sample