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

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

请求参数

Header 参数

apitoken

string

apitoken

必需

Body 参数application/json

data

object (InSearchesDdc)

必需

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

ddcId

string

DDC ID

可选

示例值:

123

ddcOwner

string

链账户地址

可选

示例值:

0x000000000

ddcType

integer <int32>

DDC类型

可选

示例值:

721

opbChainId

integer <int64>

可选

链标识(调用“开放联盟链框架查询”接口查询)

示例值:

page

object (InPage)

分页入参

必需

pageNum

integer <int32>

分页：从1开始

可选

示例值:

pageSize

integer <int32>

每页大小。

可选

示例值:

示例

{
  "data": {
    "ddcId": "123",
    "ddcOwner": "0x000000000",
    "ddcType": 721,
    "opbChainId": 9
  },
  "page": {
    "pageNum": 1,
    "pageSize": 5
  }
}

返回响应

🟢200成功

*/*

Body

code

integer <int32>

必需

成功：0，失败：-1

示例值:

data

array[object (OutSearchesDdc) {9}]

可选

ddcGenerateState

integer <int32>

必需

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

示例值:

ddcId

string

DDC ID

可选

示例值:

123

ddcOwner

string

链账户地址

必需

示例值:

0x0000000

ddcState

integer <int32>

必需

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

示例值:

ddcType

integer <int32>

DDC类型

必需

示例值:

721

generateDate

string

生成时间

可选

示例值:

2022-11-09 11:00:00

opbChainId

integer <int64>

链标识

必需

示例值:

opsMgrState

integer <int32>

必需

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

示例值:

platformDdcCode

string

DDC CODE

必需

示例值:

SSSSSSS

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": [
    {
      "ddcGenerateState": 1,
      "ddcId": "123",
      "ddcOwner": "0x0000000",
      "ddcState": 1,
      "ddcType": 721,
      "generateDate": "2022-11-09 11:00:00",
      "opbChainId": 4,
      "opsMgrState": 1,
      "platformDdcCode": "SSSSSSS"
    }
  ],
  "errorLogCode": "0",
  "message": "0",
  "portalToken": "portaltoken",
  "resultPageInfo": {
    "firstPage": true,
    "lastPage": true,
    "pageNum": 0,
    "pageSize": 0,
    "pages": 0,
    "total": 0
  }
}

🟢201成功

🟠401没有权限

🟠403禁止访问

🟠404记录不存在