NFT列表查询 - BSN官方算力中心OpenAPI

可根据Token ID、类型、链账户地址、链类型查询

请求参数

Header 参数

apitoken

string

apitoken

必需

Body 参数application/json

data

object (InNftSearches)

必需

请求报文体，不能为null，可以为空对象

beginDate

string <date-time>

开始时间

可选

endDate

string <date-time>

结束时间

可选

opbChainId

integer <int64>

链标识

可选

示例值:

owner

string

链账户地址

可选

示例值:

0x000000000

tokenId

string

Token ID

可选

示例值:

123

tokenStatus

integer <int32>

可选

Token 状态：1=正常 4=销毁中 5=销毁 10=生成中 15=生成失败 20=发送中 25=发送失败 100=已冻结

示例值:

tokenType

integer <int32>

token 类型

可选

示例值:

721

page

object (InPage)

分页入参

必需

pageNum

integer <int32>

分页：从1开始

可选

示例值:

pageSize

integer <int32>

每页大小。

可选

示例值:

示例

{
  "data": {
    "beginDate": "2019-08-24T14:15:22Z",
    "endDate": "2019-08-24T14:15:22Z",
    "opbChainId": 9,
    "owner": "0x000000000",
    "tokenId": "123",
    "tokenStatus": 1,
    "tokenType": 721
  },
  "page": {
    "pageNum": 1,
    "pageSize": 5
  }
}

返回响应

🟢200成功

*/*

Body

code

integer <int32>

必需

成功：0，失败：-1

示例值:

data

array[object (OutNftSearches) {10}]

可选

ddcOwnerQuantity

integer <int64>

owner数量

必需

示例值:

generateDate

string

生成时间

可选

示例值:

2022-11-09 11:00:00

generateState

integer <int32>

必需

Token生成状态 1=生成中 5=正常 10=生成失败

示例值:

opbChainId

integer <int64>

链标识

必需

示例值:

opsMgrState

integer <int32>

必需

运营冻结状态 1=冻结 5=正常（解冻）

示例值:

owner

string

链账户地址

必需

示例值:

0x0000000

platformDdcCode

string

必需

Token CODE

示例值:

SSSSSSS

tokenId

string

Token Id

可选

示例值:

123

tokenState

integer <int32>

必需

Token状态 1=正常 4=销毁中 5=销毁 20=发送中 25=发送失败

示例值:

tokenType

integer <int32>

Token 类型

必需

示例值:

721

errorLogCode

string

必需

此标记同时写入到日志文件中，方便查找

示例值:

message

string

必需

都是消息编码，前端自行国际化处理

示例值:

portalToken

string

可选

凭此token可以访问共享接口，返回空则表示无法使用

示例值:

portaltoken

resultPageInfo

object (PageInfo)

可选

firstPage

boolean

可选

lastPage

boolean

可选

pageNum

integer <int32>

可选

pageSize

integer <int32>

可选

pages

integer <int32>

可选

total

integer <int64>

可选

示例

{
  "code": 0,
  "data": [
    {
      "ddcOwnerQuantity": 1,
      "generateDate": "2022-11-09 11:00:00",
      "generateState": 1,
      "opbChainId": 4,
      "opsMgrState": 1,
      "owner": "0x0000000",
      "platformDdcCode": "SSSSSSS",
      "tokenId": "123",
      "tokenState": 1,
      "tokenType": 721
    }
  ],
  "errorLogCode": "0",
  "message": "0",
  "portalToken": "portaltoken",
  "resultPageInfo": {
    "firstPage": true,
    "lastPage": true,
    "pageNum": 0,
    "pageSize": 0,
    "pages": 0,
    "total": 0
  }
}

🟢201成功

🟠401没有权限

🟠403禁止访问

🟠404记录不存在