Burns
The burns API provide users the entries to burn the NFTs.
Burn NFTs
Burn NFT by Admin
The Burn NFT by Admin API helps users to burn the corresponding NFT.
Burn NFT by admin
Bearer Open_JWT
OK
Invalid request
Internal Server error
POST /v1/burns HTTP/1.1
Host: api.nftrainbow.cn
Authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 113
{
"amount": 1,
"chain": "conflux",
"contract_address": "text",
"contract_type": "erc721",
"token_id": "text",
"user": "text"
}{
"amount": 1,
"app_id": 1,
"block_reason": 1,
"chain_id": 1,
"chain_type": 1,
"contract": "text",
"contract_type": 1,
"created_at": "text",
"deleted_at": {
"time": "text",
"valid": true
},
"error": "text",
"hash": "text",
"id": 1,
"status": 1,
"token_id": "text",
"tx_id": 1,
"updated_at": "text",
"user": "text"
}Authorization
Bearer Token
Header
string
token_id
The id of the NFT
body
string
chain
The chain type. The types include conflux and conflux_test
body
string
contract_address
The address of the contract
body
string
contract_type
The type of the contract
body
string
amount
The amount of the burned NFTs
body
integer
user
The address of the user
body
string
{
"chain": "conflux_test",
"contract_address": "cfxtest:acg1rr3cxaykwymwrajgat0vbk44wvzsrj0ftk7wb1",
"contract_type":"erc721",
"user": "cfxtest:aam1eawbm9pzp0dnwv96tts5shnbdfv9nuwu7zgzz8",
"token_id":"23",
"amount":1
}created_at
The time of creating the item in the database
string
updated_at
The time of updating the item in the database
string
deleted_at
The time of deleting the item in the database
string
id
The id of the item in the database
integer
amount
The amount of the nft
integer
app_id
The id of the app
integer
chain_id
The id of the chain. 1029-mainnet, 1-testnet
integer
chain_type
The type of the chain. 1-CFX, 2-ETH
integer
contract_type
The type of the contract. 1-ERC721, 2-ERC1155
integer
contract
The address of the nft
string
error
The error during executing tx
string
hash
The hash of the transaction
string
status
The status of the transaction. 0-pending, 1-success, 2-failed
integer
token_id
The id of the token
string
user
The address of the user
string
tx_id
The id of the transaction
integer
mint_type
The type of the minting
integer
error
The error during executing the transaction
string
{
"id": 106,
"created_at": "2022-10-11T17:18:29.494+08:00",
"updated_at": "2022-10-11T17:18:29.494+08:00",
"deleted_at": null,
"app_id": 18,
"chain_type": 1,
"chain_id": 1,
"contract": "cfxtest:acdyu08shg7mu816y0xkty81hev50g7gtu2effygtk",
"contract_type": 1,
"tx_id": 767,
"hash": "",
"status": 0,
"error": "",
"user": "cfxtest:aarep2p1rcadt0j1x0gkybggfkk97uxwty45grxxt7",
"token_id": "23",
"amount": 1
}curl --request POST \
--url https://api.nftrainbow.cn/v1/burns/ \
--header 'Authorization: Bearer {JWT}' \
--header 'Content-Type: application/json' \
--data-raw '{
"chain": "conflux_test",
"contract_address": "cfxtest:acg1rr3cxaykwymwrajgat0vbk44wvzsrj0ftk7wb1",
"contract_type":"erc721",
"user": "cfxtest:aam1eawbm9pzp0dnwv96tts5shnbdfv9nuwu7zgzz8",
"token_id":"23",
"amount":1
}'Query Operations
Query specific Burning NFT information
The Query specific Burning NFT information API helps users to query burning record according to id.
Get NFT Burn detail info
id
Bearer Open_JWT
OK
Invalid request
Internal Server error
GET /v1/burns/{id} HTTP/1.1
Host: api.nftrainbow.cn
Authorization: text
Accept: */*
{
"amount": 1,
"app_id": 1,
"block_reason": 1,
"chain_id": 1,
"chain_type": 1,
"contract": "text",
"contract_type": 1,
"created_at": "text",
"deleted_at": {
"time": "text",
"valid": true
},
"error": "text",
"hash": "text",
"id": 1,
"status": 1,
"token_id": "text",
"tx_id": 1,
"updated_at": "text",
"user": "text"
}Authorization
Bearer Token
Header
string
id
The id of the record
path
string
created_at
The time of creating the item in the database
string
updated_at
The time of updating the item in the database
string
deleted_at
The time of deleting the item in the database
string
id
The id of the item in the database
integer
amount
The amount of the nft
integer
app_id
The id of the app
integer
chain_id
The id of the chain. 1029-mainnet, 1-testnet
integer
chain_type
The type of the chain. 1-CFX, 2-ETH
integer
contract_type
The type of the contract. 1-ERC721, 2-ERC1155
integer
contract
The address of the nft
string
error
The error during executing tx
string
hash
The hash of the transaction
string
status
The status of the transaction. 0-pending, 1-success, 2-failed
integer
token_id
The id of the token
string
user
The address of the user
string
tx_id
The id of the transaction
integer
{
"id": 106,
"created_at": "2022-10-11T17:18:29.494+08:00",
"updated_at": "2022-10-11T17:18:44.02+08:00",
"deleted_at": null,
"app_id": 18,
"chain_type": 1,
"chain_id": 1,
"contract": "cfxtest:acdyu08shg7mu816y0xkty81hev50g7gtu2effygtk",
"contract_type": 1,
"tx_id": 767,
"hash": "0xc7bc8b1e33c30cd0e522d973b8ab63880549125ec12389701e7e54a6d6836bb0",
"status": 1,
"error": "",
"user": "cfxtest:aarep2p1rcadt0j1x0gkybggfkk97uxwty45grxxt7",
"token_id": "4646046442",
"amount": 1
}curl --request get \
--url https://api.nftrainbow.cn/v1/burns/105 \
--header 'Authorization: Bearer {JWT}' \
--header 'Content-Type: application/json' \ Query Burning List
The Query Burning List API helps users to query burning list.
Get the NFT burned list information.
Bearer Open_JWT
OK
Invalid request
Internal Server error
GET /v1/burns HTTP/1.1
Host: api.nftrainbow.cn
Authorization: text
Accept: */*
{
"count": 1,
"items": [
{
"amount": 1,
"app_id": 1,
"block_reason": 1,
"chain_id": 1,
"chain_type": 1,
"contract": "text",
"contract_type": 1,
"created_at": "text",
"deleted_at": {
"time": "text",
"valid": true
},
"error": "text",
"hash": "text",
"id": 1,
"status": 1,
"token_id": "text",
"tx_id": 1,
"updated_at": "text",
"user": "text"
}
]
}Authorization
Bearer Token
Header
string
page
Page Query
query
integer
1
limit
Page Query
query
integer
10
count
The count of the records
string
Items
The array of items
[]BurnTask
The BurnTask struct is showed in the following.
created_at
The time of creating the item in the database
string
updated_at
The time of updating the item in the database
string
deleted_at
The time of deleting the item in the database
string
id
The id of the item in the database
integer
amount
The amount of the nft
integer
app_id
The id of the app
integer
chain_id
The id of the chain. 1029-mainnet, 1-testnet
integer
chain_type
The type of the chain. 1-CFX, 2-ETH
integer
contract_type
The type of the contract. 1-ERC721, 2-ERC1155
integer
contract
The address of the nft
string
error
The error during executing tx
string
hash
The hash of the transaction
string
status
The status of the transaction. 0-pending, 1-success, 2-failed
integer
token_id
The id of the token
string
user
The address of the user
string
tx_id
The id of the transaction
integer
{
"count": 1,
"items": [
{
"id": 1,
"created_at": "2022-10-10T23:07:17.747+08:00",
"updated_at": "2022-10-10T23:07:36.485+08:00",
"deleted_at": null,
"app_id": 19,
"chain_type": 1,
"chain_id": 1029,
"contract": "cfx:acd1pmsj9crnr79rmmd9ne5pb5dbk51p4ydf6msz5e",
"contract_type": 2,
"tx_id": 657,
"hash": "0x26acea5c8f60aeb8964e6505e33b66cbb017185b93d7ea1fb9d4d80139a307a8",
"status": 1,
"error": "",
"user": "cfx:aat5w71vgxyumvm2bzsxshed027rwjst6e8mt3sam0",
"token_id": "9262474764",
"amount": 1
}
]
}curl --request GET \
--url https://api.nftrainbow.cn/v1/burns/ \
--header 'Authorization: Bearer {JWT}' \
--header 'Content-Type: application/json' \ Last updated