官方DDC

DDC生成

接口地址:/ddcoai/sys/v1/ddc/save

请求方式:POST

请求数据类型:application/x-www-form-urlencoded,application/json

响应数据类型:*/*

接口描述:

生成指定开放联盟链框架的ddc，‘门户配置管理-门户功能配置’勾选了官方ddc之后才能使用

请求示例:

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
apitoken	apitoken	header	true	string
inDdcSave	InDdcSave	body	true	InDdcSave	InDdcSave
ddcDesc	描述		false	string
ddcOwner	链账户地址		true	string
ddcPubTotal	发行数量：1155必填		false	string
ddcType	DDC类型(721,1155)		true	integer(int32)
imgFileBase64	文件base64编码，支持的格式(png,jpg,jpeg,bmp,gif,doc,docx,pdf)，大小限制2m		true	string
imgFileName	图片文件名称(不包含拓展名)		true	string
opbChainId	链标识(调用“开放联盟链框架查询”接口查询)		true	integer(int64)
securityData	附加数据		true	string
userTradeCode	用户第三方流水号		true	string

响应状态:

状态码	说明	schema
200	OK	ResultInfo«OutDdcTrade»
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code	成功：0，失败：-1	integer(int32)	integer(int32)
data		OutDdcTrade	OutDdcTrade
tradeCode	算力交易流水号	string
errorLogCode	此标记同时写入到日志文件中，方便查找	string
message	都是消息编码，前端自行国际化处理	string

响应示例:

DDC发送

接口地址:/ddcoai/sys/v1/ddc/send

请求方式:POST

请求数据类型:application/x-www-form-urlencoded,application/json

响应数据类型:*/*

接口描述:

发送指定开放联盟链框架的ddc到同一个算力中心方的链账户地址，‘门户配置管理-门户功能配置’勾选了官方ddc之后才能使用

请求示例:

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
apitoken	apitoken	header	true	string
inDdcSend	InDdcSend	body	true	InDdcSend	InDdcSend
ddcId	DDC ID		true	string
ddcOwner	拥有者链账户地址		true	string
ddcType	DDC类型(721,1155)		true	integer(int32)
opbChainId	链标识(调用“开放联盟链框架查询”接口查询)		true	integer(int64)
recipientAccount	接收者账户地址		true	string
securityData	附加数据		true	string
sendNumber	发送数量		true	string
userTradeCode	用户第三方流水号		true	string

响应状态:

状态码	说明	schema
200	OK	ResultInfo«OutDdcTrade»
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code	成功：0，失败：-1	integer(int32)	integer(int32)
data		OutDdcTrade	OutDdcTrade
tradeCode	算力交易流水号	string
errorLogCode	此标记同时写入到日志文件中，方便查找	string
message	都是消息编码，前端自行国际化处理	string

响应示例:

DDC销毁

接口地址:/ddcoai/sys/v1/ddc/burn

请求方式:POST

请求数据类型:application/x-www-form-urlencoded,application/json

响应数据类型:*/*

接口描述:

销毁指定开放联盟链框架的ddc且必须为同一个算力中心方，‘门户配置管理-门户功能配置’勾选了官方ddc之后才能使用

请求示例:

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
apitoken	apitoken	header	true	string
inDdcBurn	InDdcBurn	body	true	InDdcBurn	InDdcBurn
ddcId	DDC ID		true	string
ddcOwner	拥有者链账户地址		true	string
ddcType	DDC类型(721,1155)		true	integer(int32)
opbChainId	链标识(调用“开放联盟链框架查询”接口查询)		true	integer(int64)
securityData	附加数据		true	string
userTradeCode	用户第三方流水号		true	string

响应状态:

状态码	说明	schema
200	OK	ResultInfo«OutDdcTrade»
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code	成功：0，失败：-1	integer(int32)	integer(int32)
data		OutDdcTrade	OutDdcTrade
tradeCode	算力交易流水号	string
errorLogCode	此标记同时写入到日志文件中，方便查找	string
message	都是消息编码，前端自行国际化处理	string

响应示例:

DDC列表查询

接口地址:/ddcoai/sys/v1/ddc/data/searches

请求方式:POST

请求数据类型:application/x-www-form-urlencoded,application/json

响应数据类型:*/*

接口描述:

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

请求示例:

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
apitoken	apitoken	header	true	string
requestPageInfo«InSearchesDdc»	RequestPageInfo«InSearchesDdc»	body	true	RequestPageInfo«InSearchesDdc»	RequestPageInfo«InSearchesDdc»
data	请求报文体，不能为null，可以为空对象		true	InSearchesDdc	InSearchesDdc
ddcId	DDC ID		false	string
ddcOwner	链账户地址		false	string
ddcType	DDC类型		false	integer
opbChainId	链标识(调用“开放联盟链框架查询”接口查询)		false	integer
page	分页入参		true	InPage	InPage
pageNum	分页：从1开始		false	integer
pageSize	每页大小。		false	integer

响应状态:

状态码	说明	schema
200	OK	ResultInfoPage«List«OutSearchesDdc»»
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code	成功：0，失败：-1	integer(int32)	integer(int32)
data		array	OutSearchesDdc
ddcGenerateState	DDC生成状态 1=生成中 5=正常 10=生成失败	integer(int32)
ddcId	DDC ID	string
ddcOwner	链账户地址	string
ddcState	DDC状态 1=正常 4=销毁中 5=销毁 20=发送中 25=发送失败	integer(int32)
ddcType	DDC类型	integer(int32)
generateDate	生成时间	string
opbChainId	链标识	integer(int64)
opsMgrState	运营冻结状态 1=冻结 5=正常（解冻）	integer(int32)
platformDdcCode	DDC CODE	string
errorLogCode	此标记同时写入到日志文件中，方便查找	string
message	都是消息编码，前端自行国际化处理	string
resultPageInfo		PageInfo	PageInfo
firstPage		boolean
lastPage		boolean
pageNum		integer(int32)
pageSize		integer(int32)
pages		integer(int32)
total		integer(int64)

响应示例:

查看DDC详情

接口地址:/ddcoai/sys/v1/ddc/data/searches/details/ddcId

请求方式:POST

请求数据类型:application/x-www-form-urlencoded,application/json

响应数据类型:*/*

接口描述:

根据DDCID查看DDC详情

请求示例:

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
apitoken	apitoken	header	true	string
inSearchDetailsByDdcId	InSearchDetailsByDdcId	body	true	InSearchDetailsByDdcId	InSearchDetailsByDdcId
ddcId	ddc Id		true	string
ddcType	DDC类型		true	integer(int32)
opbChainId	开放联盟链id		true	integer(int64)

响应状态:

状态码	说明	schema
200	OK	ResultInfo«OutSearchDetailsByDdcId»
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code	成功：0，失败：-1	integer(int32)	integer(int32)
data		OutSearchDetailsByDdcId	OutSearchDetailsByDdcId
ddcDesc	DDC描述	string
ddcGenerateState	DDC生成状态 1=生成中 5=正常 10=生成失败	integer(int32)
ddcId	DDC ID	string
ddcState	DDC状态 1=正常 4=销毁中 5=销毁 20=发送中 25=发送失败	integer(int32)
ddcType	DDC 类型	integer(int32)
ddcUri	ddcuri	string
generateDate	生成时间	string
opbChainName	框架名称	string
opsMgrState	运营冻结状态 1=冻结 5=正常（解冻）	integer(int32)
publishQuantity	发行量（只有1155类型有值）	integer(int64)
errorLogCode	此标记同时写入到日志文件中，方便查找	string
message	都是消息编码，前端自行国际化处理	string

响应示例:

查询DDC流转记录

接口地址:/ddcoai/sys/v1/ddc/data/searches/details/tx/record

请求方式:POST

请求数据类型:application/x-www-form-urlencoded,application/json

响应数据类型:*/*

接口描述:

查询DDC流转记录

请求示例:

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
apitoken	apitoken	header	true	string
requestPageInfo«InSearchDetailsByDdcId»	RequestPageInfo«InSearchDetailsByDdcId»	body	true	RequestPageInfo«InSearchDetailsByDdcId»	RequestPageInfo«InSearchDetailsByDdcId»
data	请求报文体，不能为null，可以为空对象		true	InSearchDetailsByDdcId	InSearchDetailsByDdcId
ddcId	ddc Id		true	string
ddcType	DDC类型		true	integer
opbChainId	开放联盟链id		true	integer
page	分页入参		true	InPage	InPage
pageNum	分页：从1开始		false	integer
pageSize	每页大小。		false	integer

响应状态:

状态码	说明	schema
200	OK	ResultInfoPage«List«OutSearchDetailsByTxRecord»»
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code	成功：0，失败：-1	integer(int32)	integer(int32)
data		array	OutSearchDetailsByTxRecord
blockHeight	块高	integer(int64)
createDate	交易时间	string
receiveAccount	接收者账户	string
sendAccount	发送者账户	string
txHash	交易hash	string
txType	交易类型：20=DDC生成 22=DDC流转 23=DDC销毁	integer(int32)
errorLogCode	此标记同时写入到日志文件中，方便查找	string
message	都是消息编码，前端自行国际化处理	string
resultPageInfo		PageInfo	PageInfo
firstPage		boolean
lastPage		boolean
pageNum		integer(int32)
pageSize		integer(int32)
pages		integer(int32)
total		integer(int64)

响应示例:

DDC交易定价查询

接口地址:/ddcoai/sys/v1/ddc/fee/searches

请求方式:POST

请求数据类型:application/x-www-form-urlencoded

响应数据类型:*/*

接口描述:

查询DDC交易与算力值定值列表，算力值支持小数点后两位

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
apitoken	apitoken	header	true	string

响应状态:

状态码	说明	schema
200	OK	ResultInfo«List«OutDdcFeeSearches»»
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code	成功：0，失败：-1	integer(int32)	integer(int32)
data		array	OutDdcFeeSearches
txAmount	DDC交易价格	number(bigdecimal)
txType	DDC交易类型：20=生成 22=流转 23=销毁	integer(int32)
errorLogCode	此标记同时写入到日志文件中，方便查找	string
message	都是消息编码，前端自行国际化处理	string

响应示例:

DDC交易明细查询

接口地址:/ddcoai/sys/v1/ddc/transfer/searches

请求方式:POST

请求数据类型:application/x-www-form-urlencoded,application/json

响应数据类型:*/*

接口描述:

查询DDC交易明细列表，包含官方DDC交易的状态结果

请求示例:

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
apitoken	apitoken	header	true	string
inDdcTransferSearches	InDdcTransferSearches	body	true	InDdcTransferSearches	InDdcTransferSearches
tradeCode	算力交易流水号		false	string
txType	交易类型 20=DDC生成 22=DDC流转 23=DDC销毁		false	integer(int32)
userTradeCode	用户第三方流水号		false	string

响应状态:

状态码	说明	schema
200	OK	ResultInfo«List«OutDdcTransferSearches»»
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code	成功：0，失败：-1	integer(int32)	integer(int32)
data		array	OutDdcTransferSearches
burnQuantity	销毁数量	integer(int64)
ddcId	DdcId	string
ddcOwner	接收者账户地址	string
ddcType	DDC类型	integer(int32)
mintQuantity	生成数量	integer(int64)
opbChainId	开放联盟链链ID	integer(int64)
opbChainName	开放联盟链链名称	string
sendAccount	发送者账户地址	string
tradeCode	帐户交易编号	string
tradeQuantity	流转数量	integer(int64)
txHash	交易哈希	string
txStatus	交易状态：0=处理中 1=成功 2=失败	integer(int32)
txType	交易类型 20=DDC生成 22=DDC流转 23=DDC销毁	integer(int32)
userTradeCode	用户第三方流水号	string
errorLogCode	此标记同时写入到日志文件中，方便查找	string
message	都是消息编码，前端自行国际化处理	string

响应示例:

DDC生成#

DDC发送#

DDC销毁#

DDC列表查询#

查看DDC详情#

查询DDC流转记录#

DDC交易定价查询#

DDC交易明细查询#

DDC生成

DDC发送

DDC销毁

DDC列表查询

查看DDC详情

查询DDC流转记录

DDC交易定价查询

DDC交易明细查询