NFT API

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...'

Response sample¶

{
  "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...'

Response sample¶

{
  "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...'

Response sample¶

{
  "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...'

Response sample¶

{
  "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...'

Response sample¶

{
  "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"
}'

Response sample¶

{
  "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"
}'

Response sample¶

{
  "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	N
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"
}'

Response sample¶

{
  "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	N
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"
}'

Response sample¶

{
  "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	N
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"
}'

Response sample¶

{
  "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	N
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"
}'

Response sample¶

{
  "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"
}'

Response sample¶

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