DPR 浏览器对接接口

通用接口格式

1. 接口统一采用http post方式调用，请求内容采用JSON编码格式

2. 不分页请求格式

   {
   	"data": {
   		//	请求字段
   		“filed1”:"value1",
   		“filed2”:"value2",
   		  ...
   	}
   }
   

3. 不分页返回格式

               
               {
                 "code":200 //返回码
                 "msg":"msg"
                 "data":{ //返回数据
                   “filed1”:"value1",
                   “filed2”:"value2",
                   ...
                 }
               }
               
               

4. 时间格式
   统一用毫秒时间戳

5. 交易类型(可调用查询交易类型词典接口返回)

               
               {code:1,value:"GAS转账"}
               {code:2,value:"GAS授权"}
               {code:3,value:"DP发行"}
               {code:4,value:"DPR购买"}
               {code:5,value:"DPR交易"}
               {code:6,value:"DPR销毁"}
               
               

6. 分页请求格式

               
               {
                 "data": {
                   //	请求字段
                   “filed1”:"value1",
                   “filed2”:"value2",
                 },
                 //当前页
                 "pageNum": 1,
                 //每页数量
                 "pageSize": 1,
               }
               

7. 分页返回格式

               
                 {
                   "code":200 //返回码
                   "msg":"msg"
                   "data":[{ //返回数据
                     “filed1”:"value1",
                     “filed2”:"value2",
                       ...
                   }],
                   "page": {
                     //当前页
                     "pageNum": 0,
                     //每页数量
                     "pageSize": 0,
                     //总页数
                     "pages": 0,
                     //总数量
                     "total": 0
                   }
                 }
               
               

查询区块列表

https://{domain}/explorer/v1/block/blocks

【入参列表】

字段名称	字段类型	备注	是否必传
pageNum	int	第几页	√
pageSize	int	每页条数	√
blockHeight	int	区块高度	×

【返回列表】

字段名称	字段类型	备注
blockHash	string	区块哈希
blockHeight	int	区块高度
blockCreator	string	出块节点
blockTxCount	int	交易数量
blockTime	int	区块(创建)时间
parentBlockHash	string	父区块哈希
pageNum	int	当前页
pageSize	int	每页数量
pages	int	总数量
total	int	总页数

【排序】
按区块时间倒序

查询单个区块信息

https://{domain}/explorer/v1/block/blockInfo

【入参列表】

字段名称	字段类型	备注	是否必传
blockHash	string	区块哈希	(与区块高度二传一)
blockHeight	int	区块高度	(与区块哈希二传一)

【返回列表】

字段名称	字段类型	备注
blockHash	string	区块哈希
blockHeight	int	区块高度
blockCreator	string	出块节点
blockTxCount	int	交易数量
blockTime	int	区块(创建)时间
parentBlockHash	string	父区块哈希

查询共识节点

https://{domain}/explorer/v1/consensus/consensusNodes

【入参列表】

字段名称	字段类型	备注	是否必传
pageNum	int	第几页	√
pageSize	int	每页条数	√

【返回列表】

字段名称	字段类型	备注
nodeName	string	节点名称
nodeAddress	string	节点地址
nodePubKey	string	公钥
nodeVotingPower	int	权重
blockTotal	int	出块数量
pageNum	int	当前页
pageSize	int	每页数量
pages	int	总数量
total	int	总页数

查询交易列表

https://{domain}/explorer/v1/tx/txs

【说明】

          
            1.入参传blockHeight(区块高度)，查询区块交易列表
            2.入参传address(地址)，查询地址交易列表
            3.txType交易类型，见【通用接口格式第5点】
          
        

【入参列表】

字段名称	字段类型	备注	是否必传
pageNum	int	第几页	√
pageSize	int	每页条数	√
blockHeight	int	区块高度	×
txType	int	交易类型(见第5点)	×
address	string	地址	×
status	int	交易状态(0-失败 1成功)	×
startTime	int	开始时间	×
endTime	int	结束时间	×

【返回列表】

字段名称	字段类型	备注
txHash	string	交易哈希
txType	int	交易类型
blockHeight	int	区块高度
from	string	发起者
to	string	接收者
gasUsed	int	GAS消耗
value	int	交易值(gas交易才有)
data	string	交易内容
status	int	交易状态 0-失败 1成功
txTime	int	交易(区块)时间
pageNum	int	当前页
pageSize	int	每页数量
pages	int	总数量
total	int	总页数

【排序】
按区块时间倒序

查询交易信息

https://{domain}/explorer/v1/tx/txInfo

【入参列表】

字段名称	字段类型	备注	是否必传
txHash	string	交易哈希	√

【返回列表】

字段名称	字段类型	备注
txHash	string	交易哈希
txType	int	交易类型
blockHeight	int	区块高度
from	string	发起者
to	string	接收者
gasUsed	int	GAS消耗
value	int	交易值(gas交易才有)
data	string	交易数据
status	int	交易状态 0-失败 1成功
txTime	int	交易(区块)时间

查询DP列表

https://{domain}/explorer/v1/dp/dps

【入参列表】

字段名称	字段类型	备注	是否必传
pageNum	int	第几页	√
pageSize	int	每页条数	√
dpType	string	DP类型	×
creator	string	创建者	×
owner	string	拥有者	×
name	string	DP名称(模糊查询)	×

【返回列表】

字段名称	字段类型	备注
dpId	string	DPID
dpType	string	DP类型
creator	string	创建者
owner	string	拥有者
name	string	DP名称
url	string	链接地址
symbol	string	符号
dpHash	string	数字资产Hash
totalSupply	int	总发行量
circulation	int	流通数量
decimal	int	精度(非同质化单位固定为0)
createTime	int	创建时间
uplinkTime	int	上链时间
pageNum	int	当前页
pageSize	int	每页数量
pages	int	总数量
total	int	总页数

【排序】
按时间倒序

查询DP信息

https://{domain}/explorer/v1/dp/dpInfo

【入参列表】

字段名称	字段类型	备注	是否必传
dpId	string	链上的资产id	√

【返回列表】

字段名称	字段类型	备注
dpId	string	DPID
dpType	string	DP类型
creator	string	创建者
owner	string	拥有者
name	string	DP名称
url	string	链接地址
symbol	string	符号
dpHash	string	数字资产Hash
totalSupply	int	总发行量
circulation	int	流通数量
decimal	int	精度(非同质化单位固定为0)
createTime	int	时间
uplinkTime	int	上链时间

查询DPR列表

https://{domain}/explorer/v1/dpr/dprs

【入参列表】

字段名称	字段类型	备注	是否必传
pageNum	int	第几页	√
pageSize	int	每页条数	√
dpId	string	DPID	×
dprId	string	DPRID	×
dprOwner	string	拥有者	×
status	int	状态 0-无效 1-状态	×

【返回列表】

字段名称	字段类型	备注
dpId	string	DPID
dprId	string	DPRID
businessNo	string	业务编号
dprOwner	string	拥有者
status	int	状态 0-无效 1-正常
rightType	string	权益类型
expireTime	int	过期时间
createTime	int	时间
uplinkTime	int	上链时间
pageNum	int	当前页
pageSize	int	每页数量
pages	int	总数量
total	int	总页数

【排序】
按时间倒序

查询单个DPR信息

https://{domain}/explorer/v1/dpr/dprInfo

【入参列表】

字段名称	字段类型	备注	是否必传
dprId	string	DPRID	√

【返回列表】

字段名称	字段类型	备注
dpId	string	DPID
dprId	string	DPRID
businessNo	string	业务编号
dprOwner	string	拥有者
status	int	状态 0-无效 1-正常
rightType	string	权益类型
expireTime	int	过期时间
createTime	int	时间
uplinkTime	int	上链时间

查询DPR交易列表

https://{domain}/explorer/v1/tx/dprTxs

【入参列表】

字段名称	字段类型	备注	是否必传
pageNum	int	第几页	√
pageSize	int	每页条数	√
dprId	string	DPRID	×
address	string	from或to地址	×
status	int	交易状态	×
startTime	int	交易开始时间	×
endTime	int	交易结束时间	×

【返回列表】

字段名称	字段类型	备注
dpId	string	DPID
dprId	string	DPRID
txHash	string	交易哈希
txType	int	交易类型
blockHeight	int	区块高度
from	string	发起者
to	string	接收者
gasUsed	int	GAS消耗
value	int	交易值(gas交易才有)
data	string	交易内容
status	int	交易状态 0-失败 1成功
txTime	int	交易(区块)时间
pageNum	int	当前页
pageSize	int	每页数量
pages	int	总数量
total	int	总页数

【排序】
按区块时间倒序

查询DPR单笔交易

https://{domain}/explorer/v1/tx/dprTx

【入参列表】

字段名称	字段类型	备注	是否必传
txHash	string	交易Hash	√

【返回列表】

字段名称	字段类型	备注
dpId	string	DPID
dprId	string	DPRID
txHash	string	交易哈希
txType	int	交易类型
blockHeight	int	区块高度
from	string	发起者
to	string	接收者
gasUsed	int	GAS消耗
value	int	交易值(gas交易才有)
data	string	交易内容
status	int	交易状态 0-失败 1成功
txTime	int	交易(区块)时间

查询统计信息

https://{domain}/explorer/v1/statistics/statisticsInfo

【入参列表】

字段名称	字段类型	备注	是否必传

【返回列表】

字段名称	字段类型	备注
blockHeight	int	最新区块
consNodeCount	int	共识节点数量
dpCount	int	DP数量
dprCount	int	DPR数量
txCount	int	交易数量
genesisTime	int	创世区块时间
avgBlockTime	int	平均出块时间(最近100块)
blockTime	int	最新交易(区块)时间

查询地址详情

https://{domain}/explorer/v1/address/addressInfo

【入参列表】

字段名称	字段类型	备注	是否必传
address	* string	地址	√

【出参列表】

字段名称	字段类型	备注
address	* string	地址
gas	* int	GAS数量

查询最近交易记录列表

https://{domain}/explorer/v1/tx/txs_latest

【说明】

          
            1. 查询地址详情页面的最近交易记录
            2. 返回10条数据
            3. 如需返回更多数据请使用【查询交易列表】
          
        

【入参列表】

字段名称	字段类型	备注	是否必传
address	string	地址	√

【返回列表】

字段名称	字段类型	备注
txHash	string	交易哈希
txType	int	交易类型
blockHeight	int	区块高度
from	string	发起者
to	string	接收者
gasUsed	int	GAS消耗
value	int	交易值(gas交易才有)
data	string	交易内容
status	int	交易状态 0-失败 1成功
txTime	int	交易(区块)时间

【排序】
按区块时间倒序

查询交易类型词典

https://{domain}/explorer/v1/dict/txTypeDict

【入参列表】

字段名称	字段类型	备注	是否必传

【返回列表】

字段名称	字段类型	备注
code	string	编码
value	string	值

关键字查询

【说明】
用于浏览器上方全局搜索->("请输入地址/交易哈希/区块高度进行搜索")输入框

【规则】

          
          前端跳转：
            根据相应输入的值，跳转到相应的页面，再调用相应的接口查询跳转规则：
            1. 如果输入数字，判断为区块高度，跳转区块详情页面
            2. 如果输入的字符长度是66，则判断为交易哈希(以0x开头)，跳转交易详情页面
            3. 如果输入的字符长度是42，则判断为地址(以0x开头)，跳转到地址详情页面

          例：
            1. 输入数字，跳转区块详情页面，调用区块详情相关接口