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

post

http://api.nftrainbow.cnhttps://api.nftrainbow.cn

/v1/burns

Burn NFT by admin

Authorizations

ApiKeyAuth

Header parameters

AuthorizationstringRequired

Bearer Open_JWT

Body

application/json

amountintegerOptional

chainstring · enumRequiredPossible values:

contract_addressstringRequired

contract_typestring · enumRequiredPossible values:

token_idstringRequired

userstringOptional

Responses

200

OK

application/json

400

Invalid request

application/json

500

Internal Server error

application/json

post

/v1/burns

HTTPcURLJavaScriptPython

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

Auth

Name	Meaning	Param Type	Data Type
Authorization	Bearer Token	Header	string

Parameter

Parameter Example

Response

Response Example

Requst Sample

The token_id is the number like "123", which type is string

Query Operations

Query specific Burning NFT information

The Query specific Burning NFT information API helps users to query burning record according to id.

Burn NFT detail

get

http://api.nftrainbow.cnhttps://api.nftrainbow.cn

/v1/burns/{id}

Get NFT Burn detail info

Authorizations

ApiKeyAuth

Path parameters

idintegerRequired

id

Header parameters

AuthorizationstringRequired

Bearer Open_JWT

Responses

200

OK

application/json

400

Invalid request

application/json

500

Internal Server error

application/json

get

/v1/burns/{id}

HTTPcURLJavaScriptPython

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

Auth

Name	Meaning	Param Type	Data Type
Authorization	Bearer Token	Header	string

Parameter

Response

Response Example

Requst Sample

Query Burning List

The Query Burning List API helps users to query burning list.

Obtain the burned NFTs list

get

http://api.nftrainbow.cnhttps://api.nftrainbow.cn

/v1/burns

Get the NFT burned list information.

Authorizations

ApiKeyAuth

Header parameters

AuthorizationstringRequired

Bearer Open_JWT

Responses

200

OK

application/json

400

Invalid request

application/json

500

Internal Server error

application/json

get

/v1/burns

HTTPcURLJavaScriptPython

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"
    }
  ]
}

Auth

Name	Meaning	Param Type	Data Type
Authorization	Bearer Token	Header	string

Parameter

Response

Response Example

Requst Sample