NFT(Non-Fungible Token) API는 NFT 발행, 전송, 정보 조회 등의 기능들을 제공합니다.

NFT 컨트랙트 정보 조회

컨트랙트 주소(contract)에 해당하는 NFT 컨트랙트 정보를 조회합니다.

Request URL

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

Path Parameters

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

Header Parameters

필드명	설명	타입	필수 여부
x-network	블록체인 네트워크{ploygon, xpla}	string	Y
Authorization	API를 호출하기 위한 인증 토큰	string	Y

Responses

필드명	설명	타입
code	api 호출 결과 코드, 0:성공	number
message	결과 메시지	string
data	API 응답 데이터	json
data.name	NFT 컨트랙트 이름	string
data.symbol	NFT 컨트랙트 심볼	string

Request Sample

curl -X 'GET' \
  'https://sandbox-bc-api.qpyou.cn/core/v1/nft/0xc1aE02F65dA9819bbdE39255698193016F4aB018' \
  -H 'accept: application/json' \
  -H 'x-network: polygon' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...'

curl -X 'GET' \

'https://sandbox-bc-api.qpyou.cn/core/v1/nft/0xc1aE02F65dA9819bbdE39255698193016F4aB018' \

-H 'accept: application/json' \

-H 'x-network: polygon' \

-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...'

Response Sample

{
  "code": 0,
  "message": "success",
  "data": {
    "name": "Simple NFT",
    "symbol": "SNFT"
  }
}

{

"code": 0,

"message": "success",

"data": {

"name": "Simple NFT",

"symbol": "SNFT"

}

NFT 조회

토큰 ID(tokenId)에 해당하는 NFT 정보를 조회합니다.

Request URL

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

Path Parameters

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

Header Parameters

필드명	설명	타입	필수 여부
x-network	블록체인 네트워크{ploygon, xpla}	string	Y
Authorization	API를 호출하기 위한 인증 토큰	string	Y

Responses

필드명	설명	타입
code	api 호출 결과 코드, 0:성공	number
message	결과 메시지	string
data	API 응답 데이터	json
data.tokenUri	NFT URI입니다. `ipfs://{cid}` 형태이며 메타데이터 조회 API를 사용해 NFT 정보를 조회할 수 있습니다.	string

Request Sample

curl -X 'GET' \
  'https://sandbox-bc-api.qpyou.cn/core/v1/nft/0xc1aE02F65dA9819bbdE39255698193016F4aB018/tokens/1' \
  -H 'accept: application/json' \
  -H 'x-network: polygon' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...'

curl -X 'GET' \

'https://sandbox-bc-api.qpyou.cn/core/v1/nft/0xc1aE02F65dA9819bbdE39255698193016F4aB018/tokens/1' \

-H 'accept: application/json' \

-H 'x-network: polygon' \

-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...'

Response Sample

{
  "code": 0,
  "message": "success",
  "data": {
    "tokenUri": "ipfs://QmZcH4YvBVVRJtdn4RdbaqgspFU8gH6P9vomDpBVpAL3u4"
  }
}

{

"code": 0,

"message": "success",

"data": {

"tokenUri": "ipfs://QmZcH4YvBVVRJtdn4RdbaqgspFU8gH6P9vomDpBVpAL3u4"

}

NFT 소유자 조회

토큰 ID(tokenId)에 해당하는 NFT를 소유한 계정 정보를 조회합니다.

Request URL

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

Path Parameters

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

Header Parameters

필드명	설명	타입	필수 여부
x-network	블록체인 네트워크{ploygon, xpla}	string	Y
Authorization	API를 호출하기 위한 인증 토큰	string	Y

Responses

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

Request Sample

curl -X 'GET' \
  'https://sandbox-bc-api.qpyou.cn/core/v1/nft/0xc1aE02F65dA9819bbdE39255698193016F4aB018/tokens/1/account' \
  -H 'accept: application/json' \
  -H 'x-network: polygon' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...'

curl -X 'GET' \

'https://sandbox-bc-api.qpyou.cn/core/v1/nft/0xc1aE02F65dA9819bbdE39255698193016F4aB018/tokens/1/account' \

-H 'accept: application/json' \

-H 'x-network: polygon' \

-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...'

Response Sample

{
  "code": 0,
  "message": "success",
  "data": {
    "owner": "0x9428e6eF51FEb2201676deEc11B7E36F7c1F0765"
  }
}

{

"code": 0,

"message": "success",

"data": {

"owner": "0x9428e6eF51FEb2201676deEc11B7E36F7c1F0765"

}

NFT 전송 권한을 가진 계정 조회

특정 NFT를 전송할 권한을 가진 계정들을 조회합니다.

Request URL

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

Path Parameters

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

Header Parameters

필드명	설명	타입	필수 여부
x-network	블록체인 네트워크{ploygon, xpla}	string	Y
Authorization	API를 호출하기 위한 인증 토큰	string	Y

Responses

필드명	설명	타입
code	api 호출 결과 코드, 0:성공	number
message	결과 메시지	string
data	API 응답 데이터	json
data.spenders	NFT 전송 권한을 가진 계정 주소 목록	string[]

Request Sample

curl -X 'GET' \
  'https://sandbox-bc-api.qpyou.cn/core/v1/nft/0xc1aE02F65dA9819bbdE39255698193016F4aB018/tokens/1/approval' \
  -H 'accept: application/json' \
  -H 'x-network: polygon' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...'

curl -X 'GET' \

'https://sandbox-bc-api.qpyou.cn/core/v1/nft/0xc1aE02F65dA9819bbdE39255698193016F4aB018/tokens/1/approval' \

-H 'accept: application/json' \

-H 'x-network: polygon' \

-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...'

Response Sample

{
  "code": 0,
  "message": "success",
  "data": {
    "spenders": [
      "0x9428e6eF51FEb2201676deEc11B7E36F7c1F0765"
    ]
  }
}

{

"code": 0,

"message": "success",

"data": {

"spenders": [

"0x9428e6eF51FEb2201676deEc11B7E36F7c1F0765"

]

}

모든 NFT를 전송할 권한이 있는지 조회

owner 계정이 소유한 모든 NFT들을 operator 계정이 전송할 수 있는지 여부를 조회합니다. 모든 NFT는 contract 주소에서 발행한 NFT입니다.

Request URL

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

Path Parameters

필드명	설명	타입	필수 여부
contract	NFT 컨트랙트 주소	string	Y
owner	NFT 소유자 계정	string	Y
operator	NFT 전송 권한이 있는지 조회할 계정	string	Y

Header Parameters

필드명	설명	타입	필수 여부
x-network	블록체인 네트워크{ploygon, xpla}	string	Y
Authorization	API를 호출하기 위한 인증 토큰	string	Y

Responses

필드명	설명	타입
code	api 호출 결과 코드, 0:성공	number
message	결과 메시지	string
data	API 응답 데이터	json
data.isOperator	전송 권한이 있는지 여부	boolean

Request Sample

curl -X 'GET' \
  'https://sandbox-bc-api.qpyou.cn/core/v1/nft/0xc1aE02F65dA9819bbdE39255698193016F4aB018/account/0x9428e6eF51FEb2201676deEc11B7E36F7c1F0765/approval/0xFBd488D1b00604d3b05124d80E35FeA9A39C3296' \
  -H 'accept: application/json' \
  -H 'x-network: polygon' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...'

curl -X 'GET' \

'https://sandbox-bc-api.qpyou.cn/core/v1/nft/0xc1aE02F65dA9819bbdE39255698193016F4aB018/account/0x9428e6eF51FEb2201676deEc11B7E36F7c1F0765/approval/0xFBd488D1b00604d3b05124d80E35FeA9A39C3296' \

-H 'accept: application/json' \

-H 'x-network: polygon' \

-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...'

Response Sample

{
  "code": 0,
  "message": "success",
  "data": {
    "isOperator": true
  }
}

{

"code": 0,

"message": "success",

"data": {

"isOperator": true

}

NFT 전송하기

특정 주소(to)로 토큰을 전송하는 트랜잭션을 생성합니다. from은 토큰의 소유자이거나 전송 권한을 받은 계정이어야 합니다. 전송 받을 계정(to)이 컨트랙트이면 data를 사용해 전송 받는 컨트랙트에서 추가 작업을 할 수 있습니다.

Request URL

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

Path Parameters

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

Header Parameters

필드명	설명	타입	필수 여부
x-network	블록체인 네트워크{ploygon, xpla}	string	Y
Authorization	API를 호출하기 위한 인증 토큰	string	Y

Request Body

필드명	설명	타입	필수 여부
encoded	반환받을 트랜잭션의 인코딩 여부 `true`: `data.rawTx`으로 인코딩된 Raw Transaction String을 받습니다. `false`: `data.rawTx`으로 인코딩을 디코딩한 JSON 결과값을 받습니다.	boolean	N
from	토큰을 전송할 계정 주소	string	Y
to	토큰을 받을 계정 주소	string	Y
tokenId	전송할 토큰 ID	string	Y
data	컨트랙트로 전송 시 전달할 데이터	string	N

Responses

필드명	설명	타입
code	api 호출 결과 코드, 0:성공	number
message	결과 메시지	string
data	API 응답 데이터	json
data.rawTx	트랜잭션 데이터	string 또는 json
data.hashedTx	해시한 `data.rawTx`입니다. API 헤더 `x-network`가 polygon이고 Request Body `from`이 다중 서명 지갑 주소일 때에만 이 값을 받습니다.	string
data.requestId	API 요청을 식별할 수 있는 고유값	string

Request Sample

curl -X 'POST' \
  'http://sandbox-bc-api.qpyou.cn/core/v1/nft/0xA3F4308Ed655f962dD7CA180545c21718fAE49AD/transfer' \
  -H 'accept: */*' \
  -H 'x-network: polygon' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...' \
  -H 'Content-Type: application/json' \
  -d '{
  "encoded": true,
  "from": "0xFBd488D1b00604d3b05124d80E35FeA9A39C3296",
  "to": "0x9428e6eF51FEb2201676deEc11B7E36F7c1F0765",
  "tokenId": "1"
}'

curl -X 'POST' \

'http://sandbox-bc-api.qpyou.cn/core/v1/nft/0xA3F4308Ed655f962dD7CA180545c21718fAE49AD/transfer' \

-H 'accept: */*' \

-H 'x-network: polygon' \

-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...' \

-H 'Content-Type: application/json' \

-d '{

"encoded": true,

"from": "0xFBd488D1b00604d3b05124d80E35FeA9A39C3296",

"to": "0x9428e6eF51FEb2201676deEc11B7E36F7c1F0765",

"tokenId": "1"

Response Sample

{
  "code": 0,
  "message": "success",
  "data": {
    "rawTx": "02f8738301388181c2846fc23ac0846fc23ad882cdc49494853bdc9c6add50d7842d1a3117fab38545747080b8...",
    "hashedTx": "0x53e8783e4da707daf58c96a8cea278e7b2a8a5f185af0913b518974556c79076...",
    "requestId": "4d4aa1e5-2bfe-4080-b42f-03319810fe29"
  }
}

{

"code": 0,

"message": "success",

"data": {

"rawTx": "02f8738301388181c2846fc23ac0846fc23ad882cdc49494853bdc9c6add50d7842d1a3117fab38545747080b8...",

"hashedTx": "0x53e8783e4da707daf58c96a8cea278e7b2a8a5f185af0913b518974556c79076...",

"requestId": "4d4aa1e5-2bfe-4080-b42f-03319810fe29"

}

NFT 발행하기

특정 주소(to)로 토큰을 발행하는 트랜잭션을 생성합니다. from은 발행 권한을 가진 계정이어야 합니다.

Request URL

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

Path Parameters

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

Header Parameters

필드명	설명	타입	필수 여부
x-network	블록체인 네트워크{ploygon, xpla}	string	Y
Authorization	API를 호출하기 위한 인증 토큰	string	Y

Request Body

필드명	설명	타입	필수 여부
encoded	반환받을 트랜잭션의 인코딩 여부 `true`: `data.rawTx`으로 인코딩된 Raw Transaction String을 받습니다. `false`: `data.rawTx`으로 인코딩을 디코딩한 JSON 결과값을 받습니다.	boolean	N
from	토큰을 발행할 계정 주소입니다. 발행 권한을 가진 계정이어야 합니다.	string	Y
to	토큰을 받을 계정 주소	string	Y
tokenId	발행할 토큰 ID	string	Y
tokenUri	메타데이터 업로드 후 획득한 메타데이터의 URI(`data.uri`)	string	Y

Responses

필드명	설명	타입
code	api 호출 결과 코드, 0:성공	number
message	결과 메시지	string
data	API 응답 데이터	json
data.rawTx	트랜잭션 데이터	string 또는 json
data.hashedTx	해시한 `data.rawTx`입니다. API 헤더 `x-network`가 polygon이고 Request Body `from`이 다중 서명 지갑 주소일 때에만 이 값을 받습니다.	string
data.requestId	API 요청을 식별할 수 있는 고유값	string

Request Sample

curl -X 'POST' \
  'https://sandbox-bc-api.qpyou.cn/core/v1/nft/0xA3F4308Ed655f962dD7CA180545c21718fAE49AD/mint' \
  -H 'accept: */*' \
  -H 'x-network: polygon' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...' \
  -H 'Content-Type: application/json' \
  -d '{
  "encoded": true,
  "from": "0x9428e6eF51FEb2201676deEc11B7E36F7c1F0765",
  "to": "0xFBd488D1b00604d3b05124d80E35FeA9A39C3296",
  "tokenId": "11",
  "tokenUri": "ipfs://QmZcH4YvBVVRJtdn4RdbaqgspFU8gH6P9vomDpBVpAL3u4/11"
}'

curl -X 'POST' \

'https://sandbox-bc-api.qpyou.cn/core/v1/nft/0xA3F4308Ed655f962dD7CA180545c21718fAE49AD/mint' \

-H 'accept: */*' \

-H 'x-network: polygon' \

-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...' \

-H 'Content-Type: application/json' \

-d '{

"encoded": true,

"from": "0x9428e6eF51FEb2201676deEc11B7E36F7c1F0765",

"to": "0xFBd488D1b00604d3b05124d80E35FeA9A39C3296",

"tokenId": "11",

"tokenUri": "ipfs://QmZcH4YvBVVRJtdn4RdbaqgspFU8gH6P9vomDpBVpAL3u4/11"

Response Sample

{
  "code": 0,
  "message": "success",
  "data": {
    "rawTx": "02f8738301388181c2846fc23ac0846fc23ad882cdc49494853bdc9c6add50d7842d1a3117fab38545747080b8...",
    "hashedTx": "0x53e8783e4da707daf58c96a8cea278e7b2a8a5f185af0913b518974556c79076...",
    "requestId": "4d4aa1e5-2bfe-4080-b42f-03319810fe29"
  }
}

{

"code": 0,

"message": "success",

"data": {

"rawTx": "02f8738301388181c2846fc23ac0846fc23ad882cdc49494853bdc9c6add50d7842d1a3117fab38545747080b8...",

"hashedTx": "0x53e8783e4da707daf58c96a8cea278e7b2a8a5f185af0913b518974556c79076...",

"requestId": "4d4aa1e5-2bfe-4080-b42f-03319810fe29"

}

NFT를 전송할 권한 부여

특정 토큰을 전송할 권한을 to 계정에게 부여하는 트랜잭션을 생성합니다. from은 해당 토큰의 실제 소유자 계정이어야 합니다.

Request URL

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

Path Parameters

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

Header Parameters

필드명	설명	타입	필수 여부
x-network	블록체인 네트워크{ploygon, xpla}	string	Y
Authorization	API를 호출하기 위한 인증 토큰	string	Y

Request Body

필드명 설명 타입 필수 여부

encoded

반환받을 트랜잭션의 인코딩 여부

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

boolean

from 토큰 소유자 계정 주소 string Y

to 전송 권한을 부여할 계정 주소 string Y

Responses

필드명	설명	타입
code	api 호출 결과 코드, 0:성공	number
message	결과 메시지	string
data	API 응답 데이터	json
data.rawTx	트랜잭션 데이터	string 또는 json
data.hashedTx	해시한 `data.rawTx`입니다. API 헤더 `x-network`가 polygon이고 Request Body `from`이 다중 서명 지갑 주소일 때에만 이 값을 받습니다.	string
data.requestId	API 요청을 식별할 수 있는 고유값	string

Request Sample

curl -X 'POST' \
  'https://sandbox-bc-api.qpyou.cn/core/v1/nft/0xA3F4308Ed655f962dD7CA180545c21718fAE49AD/approve/1' \
  -H 'accept: */*' \
  -H 'x-network: polygon' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...' \
  -H 'Content-Type: application/json' \
  -d '{
  "encoded": true,
  "from": "0xFBd488D1b00604d3b05124d80E35FeA9A39C3296",
  "to": "0x9428e6eF51FEb2201676deEc11B7E36F7c1F0765"
}'

curl -X 'POST' \

'https://sandbox-bc-api.qpyou.cn/core/v1/nft/0xA3F4308Ed655f962dD7CA180545c21718fAE49AD/approve/1' \

-H 'accept: */*' \

-H 'x-network: polygon' \

-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...' \

-H 'Content-Type: application/json' \

-d '{

"encoded": true,

"from": "0xFBd488D1b00604d3b05124d80E35FeA9A39C3296",

"to": "0x9428e6eF51FEb2201676deEc11B7E36F7c1F0765"

Response Sample

{
  "code": 0,
  "message": "success",
  "data": {
    "rawTx": "02f8738301388181c2846fc23ac0846fc23ad882cdc49494853bdc9c6add50d7842d1a3117fab38545747080b8...",
    "hashedTx": "0x53e8783e4da707daf58c96a8cea278e7b2a8a5f185af0913b518974556c79076...",
    "requestId": "4d4aa1e5-2bfe-4080-b42f-03319810fe29"
  }
}

{

"code": 0,

"message": "success",

"data": {

"rawTx": "02f8738301388181c2846fc23ac0846fc23ad882cdc49494853bdc9c6add50d7842d1a3117fab38545747080b8...",

"hashedTx": "0x53e8783e4da707daf58c96a8cea278e7b2a8a5f185af0913b518974556c79076...",

"requestId": "4d4aa1e5-2bfe-4080-b42f-03319810fe29"

}

모든 NFT 전송 권한 부여

from 계정이 소유한 모든 토큰을 전송할 권한을 to 계정에게 부여하는 트랜잭션을 생성합니다. from 계정이 앞으로 소유할 토큰을 전송할 권한도 to 계정이 모두 갖습니다.

Request URL

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

Path Parameters

필드명	설명	타입	필수 여부
contract	NFT 컨트랙트 주소입니다. 이 컨트랙트에서 발행한 모든 NFT를 전송할 권한을 부여합니다.	string	Y

Header Parameters

필드명	설명	타입	필수 여부
x-network	블록체인 네트워크{ploygon, xpla}	string	Y
Authorization	API를 호출하기 위한 인증 토큰	string	Y

Request Body

필드명 설명 타입 필수 여부

encoded

반환받을 트랜잭션의 인코딩 여부

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

boolean

from 토큰 소유자 계정 주소 string Y

to 전송 권한을 부여할 계정 주소 string Y

Responses

필드명	설명	타입
code	api 호출 결과 코드, 0:성공	number
message	결과 메시지	string
data	API 응답 데이터	json
data.rawTx	트랜잭션 데이터	string 또는 json
data.hashedTx	해시한 `data.rawTx`입니다. API 헤더 `x-network`가 polygon이고 Request Body `from`이 다중 서명 지갑 주소일 때에만 이 값을 받습니다.	string
data.requestId	API 요청을 식별할 수 있는 고유값	string

Request Sample

curl -X 'POST' \
  'https://sandbox-bc-api.qpyou.cn/core/v1/nft/0xA3F4308Ed655f962dD7CA180545c21718fAE49AD/approve' \
  -H 'accept: */*' \
  -H 'x-network: polygon' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...' \
  -H 'Content-Type: application/json' \
  -d '{
  "encoded": true,
  "from": "0xFBd488D1b00604d3b05124d80E35FeA9A39C3296",
  "to": "0x9428e6eF51FEb2201676deEc11B7E36F7c1F0765"
}'

curl -X 'POST' \

'https://sandbox-bc-api.qpyou.cn/core/v1/nft/0xA3F4308Ed655f962dD7CA180545c21718fAE49AD/approve' \

-H 'accept: */*' \

-H 'x-network: polygon' \

-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...' \

-H 'Content-Type: application/json' \

-d '{

"encoded": true,

"from": "0xFBd488D1b00604d3b05124d80E35FeA9A39C3296",

"to": "0x9428e6eF51FEb2201676deEc11B7E36F7c1F0765"

Response Sample

{
  "code": 0,
  "message": "success",
  "data": {
    "rawTx": "02f8738301388181c2846fc23ac0846fc23ad882cdc49494853bdc9c6add50d7842d1a3117fab38545747080b8...",
    "hashedTx": "0x53e8783e4da707daf58c96a8cea278e7b2a8a5f185af0913b518974556c79076...",
    "requestId": "4d4aa1e5-2bfe-4080-b42f-03319810fe29"
  }
}

{

"code": 0,

"message": "success",

"data": {

"rawTx": "02f8738301388181c2846fc23ac0846fc23ad882cdc49494853bdc9c6add50d7842d1a3117fab38545747080b8...",

"hashedTx": "0x53e8783e4da707daf58c96a8cea278e7b2a8a5f185af0913b518974556c79076...",

"requestId": "4d4aa1e5-2bfe-4080-b42f-03319810fe29"

}

NFT 전송 권한을 해제

to 계정에게 부여했던 토큰 전송 권한을 다시 회수하는 트랜잭션을 생성합니다. from은 해당 토큰의 실제 소유자 계정이어야 합니다.

Request URL

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

Path Parameters

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

Header Parameters

필드명	설명	타입	필수 여부
x-network	블록체인 네트워크{ploygon, xpla}	string	Y
Authorization	API를 호출하기 위한 인증 토큰	string	Y

Request Body

필드명 설명 타입 필수 여부

encoded

반환받을 트랜잭션의 인코딩 여부

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

boolean

from 토큰 소유자 계정 주소 string Y

to 전송 권한을 회수할 계정 주소 (Polygon 블록체인 사용 시 이 값 생략) string N

Responses

필드명	설명	타입
code	api 호출 결과 코드, 0:성공	number
message	결과 메시지	string
data	API 응답 데이터	json
data.rawTx	트랜잭션 데이터	string 또는 json
data.hashedTx	해시한 `data.rawTx`입니다. API 헤더 `x-network`가 polygon이고 Request Body `from`이 다중 서명 지갑 주소일 때에만 이 값을 받습니다.	string
data.requestId	API 요청을 식별할 수 있는 고유값	string

Request Sample

curl -X 'POST' \
  'https://sandbox-bc-api.qpyou.cn/core/v1/nft/0xA3F4308Ed655f962dD7CA180545c21718fAE49AD/revoke/1' \
  -H 'accept: */*' \
  -H 'x-network: polygon' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...' \
  -H 'Content-Type: application/json' \
  -d '{
  "encoded": true,
  "from": "0xFBd488D1b00604d3b05124d80E35FeA9A39C3296",
  "to": "0x9428e6eF51FEb2201676deEc11B7E36F7c1F0765"
}'

curl -X 'POST' \

'https://sandbox-bc-api.qpyou.cn/core/v1/nft/0xA3F4308Ed655f962dD7CA180545c21718fAE49AD/revoke/1' \

-H 'accept: */*' \

-H 'x-network: polygon' \

-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...' \

-H 'Content-Type: application/json' \

-d '{

"encoded": true,

"from": "0xFBd488D1b00604d3b05124d80E35FeA9A39C3296",

"to": "0x9428e6eF51FEb2201676deEc11B7E36F7c1F0765"

Response Sample

{
  "code": 0,
  "message": "success",
  "data": {
    "rawTx": "02f8738301388181c2846fc23ac0846fc23ad882cdc49494853bdc9c6add50d7842d1a3117fab38545747080b8...",
    "hashedTx": "0x53e8783e4da707daf58c96a8cea278e7b2a8a5f185af0913b518974556c79076...",
    "requestId": "4d4aa1e5-2bfe-4080-b42f-03319810fe29"
  }
}

{

"code": 0,

"message": "success",

"data": {

"rawTx": "02f8738301388181c2846fc23ac0846fc23ad882cdc49494853bdc9c6add50d7842d1a3117fab38545747080b8...",

"hashedTx": "0x53e8783e4da707daf58c96a8cea278e7b2a8a5f185af0913b518974556c79076...",

"requestId": "4d4aa1e5-2bfe-4080-b42f-03319810fe29"

}

모든 NFT 전송 권한 해제

to 계정에게 부여했던 모든 토큰의 전송 권한을 다시 회수하는 트랜잭션을 생성합니다. from은 해당 토큰의 실제 소유자 계정이어야 합니다. ERC-721 토큰(Ethereum, Polygon)은 to 계정 주소가 필요하지 않습니다.

Request URL

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

Path Parameters

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

Header Parameters

필드명	설명	타입	필수 여부
x-network	블록체인 네트워크{ploygon, xpla}	string	Y
Authorization	API를 호출하기 위한 인증 토큰	string	Y

Request Body

필드명 설명 타입 필수 여부

encoded

반환받을 트랜잭션의 인코딩 여부

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

boolean

from 토큰 소유자 계정 주소 string Y

to 전송 권한을 해제할 계정 주소 (Polygon 블록체인 사용 시 이 값 생략) string N

Responses

필드명	설명	타입
code	api 호출 결과 코드, 0:성공	number
message	결과 메시지	string
data	API 응답 데이터	json
data.rawTx	트랜잭션 데이터	string 또는 json
data.hashedTx	해시한 `data.rawTx`입니다. API 헤더 `x-network`가 polygon이고 Request Body `from`이 다중 서명 지갑 주소일 때에만 이 값을 받습니다.	string
data.requestId	API 요청을 식별할 수 있는 고유값	string

Request Sample

curl -X 'POST' \
  'https://sandbox-bc-api.qpyou.cn/core/v1/nft/0xA3F4308Ed655f962dD7CA180545c21718fAE49AD/revoke' \
  -H 'accept: */*' \
  -H 'x-network: polygon' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...' \
  -H 'Content-Type: application/json' \
  -d '{
  "encoded": true,
  "from": "0xFBd488D1b00604d3b05124d80E35FeA9A39C3296",
  "to": "0x9428e6eF51FEb2201676deEc11B7E36F7c1F0765"
}'

curl -X 'POST' \

'https://sandbox-bc-api.qpyou.cn/core/v1/nft/0xA3F4308Ed655f962dD7CA180545c21718fAE49AD/revoke' \

-H 'accept: */*' \

-H 'x-network: polygon' \

-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...' \

-H 'Content-Type: application/json' \

-d '{

"encoded": true,

"from": "0xFBd488D1b00604d3b05124d80E35FeA9A39C3296",

"to": "0x9428e6eF51FEb2201676deEc11B7E36F7c1F0765"

Response Sample

{
  "code": 0,
  "message": "success",
  "data": {
    "rawTx": "02f8738301388181c2846fc23ac0846fc23ad882cdc49494853bdc9c6add50d7842d1a3117fab38545747080b8...",
    "hashedTx": "0x53e8783e4da707daf58c96a8cea278e7b2a8a5f185af0913b518974556c79076...",
    "requestId": "4d4aa1e5-2bfe-4080-b42f-03319810fe29"
  }
}

{

"code": 0,

"message": "success",

"data": {

"rawTx": "02f8738301388181c2846fc23ac0846fc23ad882cdc49494853bdc9c6add50d7842d1a3117fab38545747080b8...",

"hashedTx": "0x53e8783e4da707daf58c96a8cea278e7b2a8a5f185af0913b518974556c79076...",

"requestId": "4d4aa1e5-2bfe-4080-b42f-03319810fe29"

}

NFT 컨트랙트 배포

표준(ERC-721) NFT 컨트랙트를 배포하는 트랜잭션을 생성합니다.

Request URL

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

Header Parameters

필드명	설명	타입	필수 여부
x-network	블록체인 네트워크{ploygon, xpla}	string	Y
Authorization	API를 호출하기 위한 인증 토큰	string	Y

Request Body

필드명	설명	타입	필수 여부
encoded	반환받을 트랜잭션의 인코딩 여부 `true`: `data.rawTx`으로 인코딩된 Raw Transaction String을 받습니다. `false`: `data.rawTx`으로 인코딩을 디코딩한 JSON 결과값을 받습니다.	boolean	N
from	NFT 컨트랙트를 배포할 계정 주소	string	Y
name	NFT 컨트랙트 이름	string	Y
symbol	NFT 컨트랙트 심볼	string	Y
minter	이 NFT 컨트랙트에서 NFT를 발행할 수 있는 계정 주소입니다.	string	Y

Responses

필드명	설명	타입
code	api 호출 결과 코드, 0:성공	number
message	결과 메시지	string
data	API 응답 데이터	json
data.rawTx	트랜잭션 데이터	string 또는 json
data.hashedTx	해시한 `data.rawTx`입니다. API 헤더 `x-network`가 polygon이고 Request Body `from`이 다중 서명 지갑 주소일 때에만 이 값을 받습니다.	string
data.requestId	API 요청을 식별할 수 있는 고유값	string

Request Sample

curl -X 'POST' \
  'https://sandbox-bc-api.qpyou.cn/core/v1/nft/contract' \
  -H 'accept: */*' \
  -H 'x-network: polygon' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...' \
  -H 'Content-Type: application/json' \
  -d '{
  "encoded": true,
  "from": "0x9428e6eF51FEb2201676deEc11B7E36F7c1F0765",
  "name": "Simple NFT",
  "symbol": "SNFT",
  "minter": "0x9428e6eF51FEb2201676deEc11B7E36F7c1F0765"
}'

curl -X 'POST' \

'https://sandbox-bc-api.qpyou.cn/core/v1/nft/contract' \

-H 'accept: */*' \

-H 'x-network: polygon' \

-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...' \

-H 'Content-Type: application/json' \

-d '{

"encoded": true,

"from": "0x9428e6eF51FEb2201676deEc11B7E36F7c1F0765",

"name": "Simple NFT",

"symbol": "SNFT",

"minter": "0x9428e6eF51FEb2201676deEc11B7E36F7c1F0765"

Response Sample

{
  "code": 0,
  "message": "success",
  "data": {
    "rawTx": "02f8738301388181c2846fc23ac0846fc23ad882cdc49494853bdc9c6add50d7842d1a3117fab38545747080b8...",
    "hashedTx": "0x53e8783e4da707daf58c96a8cea278e7b2a8a5f185af0913b518974556c79076...",
    "requestId": "4d4aa1e5-2bfe-4080-b42f-03319810fe29"
  }
}

{

"code": 0,

"message": "success",

"data": {

"rawTx": "02f8738301388181c2846fc23ac0846fc23ad882cdc49494853bdc9c6add50d7842d1a3117fab38545747080b8...",

"hashedTx": "0x53e8783e4da707daf58c96a8cea278e7b2a8a5f185af0913b518974556c79076...",

"requestId": "4d4aa1e5-2bfe-4080-b42f-03319810fe29"

}

NFT API

NFT 컨트랙트 정보 조회

Request URL

Path Parameters

Header Parameters

Responses

Request Sample

Response Sample

NFT 조회

Request URL

Path Parameters

Header Parameters

Responses

Request Sample

Response Sample

NFT 소유자 조회

Request URL

Path Parameters

Header Parameters

Responses

Request Sample

Response Sample

NFT 전송 권한을 가진 계정 조회

Request URL

Path Parameters

Header Parameters

Responses

Request Sample

Response Sample

모든 NFT를 전송할 권한이 있는지 조회

Request URL

Path Parameters

Header Parameters

Responses

Request Sample

Response Sample

NFT 전송하기

Request URL

Path Parameters

Header Parameters

Request Body

Responses

Request Sample

Response Sample

NFT 발행하기

Request URL

Path Parameters

Header Parameters

Request Body

Responses

Request Sample

Response Sample

NFT를 전송할 권한 부여

Request URL

Path Parameters

Header Parameters

Request Body

Responses

Request Sample

Response Sample

모든 NFT 전송 권한 부여

Request URL

Path Parameters

Header Parameters

Request Body

Responses

Request Sample

Response Sample

NFT 전송 권한을 해제

Request URL

Path Parameters

Header Parameters

Request Body

Responses

Request Sample

Response Sample

모든 NFT 전송 권한 해제

Request URL

Path Parameters

Header Parameters