Data Dealer

简介
接口规范

简介

在本体去中心化数据交换框架（DDXF）中，Data Dealer 作为中间层，用于降低数据需求方与数据提供方接入到 DDXF 的复杂度，让分散在全球的数据交换方能够便捷地在区块链上进行可信数据交换。

端到端数据加密。
实时化交易清算。
交易摩擦系数小。
广泛的开放市场。
可追溯的交易记录。

接口规范

账户管理

数据需求方注册

提交手机号码，密码
返回 ONT ID

url：/api/v1/ontid/register/demander/phone
method：POST

请求：

{
    "phone":"86*15821703553",
    "password":"12345678"
}

Field_Name	Type	Description
phone	String	手机号码
password	String	设置密码

响应：

{
    "action":"demanderRegister",
    "version":"v1",
    "error":0,
    "desc":"SUCCESS",
    "result": "did:ont:AR9cMgFaPNDw82v1aGjmB18dfA4BvtmoeN"
}

Field_Name	Type	Description
action	String	动作标志
version	String	版本号
error	int	错误码
desc	String	成功为SUCCESS，失败为错误描述
result	String	成功返回ontid，失败返回""

数据提供方注册

提交手机号码，密码
返回 ONT ID

url：/api/v1/ontid/register/provider/phone
method：POST

请求：

{
    "phone":"86*15821703553",
    "password":"12345678"
}

Field_Name	Type	Description
phone	String	手机号码
password	String	设置密码

响应：

{
    "action":"providerRegister",
    "version":"v1",
    "error":0,
    "desc":"SUCCESS",
    "result": "did:ont:AcrgWfbSPxMR1BNxtenRCCGpspamMWhLuL"
}

Field_Name	Type	Description
action	String	动作标志
version	String	版本号
error	int	错误码
desc	String	成功为SUCCESS，失败为错误描述
result	String	成功返回ontid，失败返回""

数据需求方

查询订单

提供买方信息
返回购买订单列表

url：/api/v1/datadealer/buyer/list
method：POST

请求：

{
	"dataDemander":"did:ont:AR9cMgFaPNDw82v1aGjmB18dfA4BvtmoeN"
}

Field_Name	Type	Description
dataDemander	String	数据需求方ontid

响应：

{
	"action":"buyerList",
	"version":"v1",
	"error":0,
	"desc":"SUCCESS",
	"result": [{
              	"orderId": "22bb3e7b-e1f1-4c32-a646-6e0611cf78ed",
              	"dataProvider": "did:ont:AKRwxnCzPgBHRKczVxranWimQBFBsVkb1y",
              	"dataIdList": ["6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb7875b4b"],
              	"buyDate": "2019-3-20",
              	"state": "deliveredOnchain"
              }]
}

Field_Name	Type	Description
action	String	动作标志
version	String	版本号
error	int	错误码
desc	String	成功为SUCCESS，失败为错误描述
result	String	成功返回orderList，失败返回""

购买数据

提供买方，卖方，数据信息
验证信息
调用合约处理交易
返回true

url：/api/v1/datadealer/buyer/buy
method：POST

请求：

{
	"dataDemander":"did:ont:AR9cMgFaPNDw82v1aGjmB18dfA4BvtmoeN",
	"password": "12345678",
	"dataProvider": "did:ont:AcrgWfbSPxMR1BNxtenRCCGpspamMWhLuO",
	"tokenContractAddress": "16edbe366d1337eb510c2ff61099424c94aeef02",
	"dataIdList": ["6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb7875b4b","d4735e3a265e16eee03f59718b9b5d03019c07d8b6c51f90da3a666eec13ab35","4e07408562bedb8b60ce05c1decfe3ad16b72230967de01f640b7e4729b49fce"],
	"priceList": [1,1,1],
	"waitReceiveEncListTime": 5000
}

Field_Name	Type	Description
dataDemander	String	数据需求方ontid
password	String	数据需求方密码
dataProvider	String	数据提供方ontid
tokenContractAddress	String	同质化通证的合约地址，付款合约地址可以是ont、ong、OEP4
dataIdList	List	所购数据的 `SHA256` 哈希值列表
priceList	List	所购数据的价格列表
waitReceiveEncListTime	Integer	等待数据需求方从合约中取出提取数据所必须的加密信息列表的最大时间上限

响应：

{
	"action":"buy",
	"version":"v1",
	"error":0,
	"desc":"SUCCESS",
	"result": {
	   "orderId": "22bb3e7b-e1f1-4c32-a646-6e0611cf78ed"
	}
}

Field_Name	Type	Description
action	String	动作标志
version	String	版本号
error	int	错误码
desc	String	成功为SUCCESS，失败为错误描述
result	String	成功返回true，失败返回""

取消订单

提供买方信息，订单ID
验证信息
调用合约取消交易
返回true

url：/api/v1/datadealer/buyer/cancel
method：POST

请求：

{
	"dataDemander":"did:ont:AR9cMgFaPNDw82v1aGjmB18dfA4BvtmoeN",
	"password": "12345678",
	"orderId": "22bb3e7b-e1f1-4c32-a646-6e0611cf78ed"
}

Field_Name	Type	Description
dataDemander	String	数据需求方ontid
password	String	数据需求方密码
orderId	String	订单ID

响应：

{
	"action":"buyerCancel",
	"version":"v1",
	"error":0,
	"desc":"SUCCESS",
	"result": true
}

Field_Name	Type	Description
action	String	动作标志
version	String	版本号
error	int	错误码
desc	String	成功为SUCCESS，失败为错误描述
result	String	成功返回true，失败返回""

获取数据提取信息

提供买方信息，订单ID
验证信息
调用合约获取加密后的数据提取信息
返回true

url：/api/v1/datadealer/buyer/receive
method：POST

请求：

{
	"dataDemander":"did:ont:AR9cMgFaPNDw82v1aGjmB18dfA4BvtmoeN",
	"password": "12345678",
	"orderId": "22bb3e7b-e1f1-4c32-a646-6e0611cf78ed"
}

Field_Name	Type	Description
dataDemander	String	数据需求方ontid
password	String	数据需求方密码
orderId	String	订单ID

响应：

{
	"action":"receiveMessage",
	"version":"v1",
	"error":0,
	"desc":"SUCCESS",
	"result": true
}

Field_Name	Type	Description
action	String	动作标志
version	String	版本号
error	int	错误码
desc	String	成功为SUCCESS，失败为错误描述
result	String	成功返回true，失败返回""

数据提供方

发送加密数据提取信息

提供卖方信息，订单ID，url，一次性密码
获取买方信息
将一次性密码和数据地址用买方公钥加密,并锁到只能合约
返回true

url：/api/v1/datadealer/seller/sell
method：POST

请求：

{
	"dataProvider":"did:ont:AKRwxnCzPgBHRKczVxranWimQBFBsVkb1y",
	"password":"12345678",
	"orderId": "22bb3e7b-e1f1-4c32-a646-6e0611cf78ed",
	"encMessageList": ["http://data1.com","http://data2.com"]
}

Field_Name	Type	Description
dataProvider	String	数据提供方ontid
password	String	数据提供方密码
orderId	String	订单id
encMessageList	List	加密消息列表，数据提供方在其中添加数据需求方用于提取数据所必须的加密信息

响应：

{
	"action":"deliver",
	"version":"v1",
	"error":0,
	"desc":"SUCCESS",
	"result": true
}

Field_Name	Type	Description
action	String	动作标志
version	String	版本号
error	int	错误码
desc	String	成功为SUCCESS，失败为错误描述
result	String	成功返回true，失败返回""

收取通证

url：/api/v1/datadealer/seller/confirm
method：POST

请求：

{
	"dataProvider":"did:ont:AKRwxnCzPgBHRKczVxranWimQBFBsVkb1y",
	"password": "12345678",
	"orderId": "22bb3e7b-e1f1-4c32-a646-6e0611cf78ed"
}

Field_Name	Type	Description
dataDemander	String	数据需求方ontid
password	String	数据需求方密码
orderId	String	订单ID

响应：

{
	"action":"confirm",
	"version":"v1",
	"error":0,
	"desc":"SUCCESS",
	"result": true
}

Field_Name	Type	Description
action	String	动作标志
version	String	版本号
error	int	错误码
desc	String	成功为SUCCESS，失败为错误描述
result	String	成功返回true，失败返回""

工具接口

查询订单

提供 ONTID。
查询 ONTID 所对应的订单列表。

url：/api/v1/datadealer/tools/orders
method：POST

请求：

{
	"ONTID":"did:ont:AKRwxnCzPgBHRKczVxranWimQBFBsVkb1y",
	"provider": 0
}

Field_Name	Type	Description
ONTID	String	ONTID
provider	Int	is data provider if and noly if equals to 0, otherwise, data demander

响应：

	{
	"action":"queryOrders",
	"version":"v1",
	"error":0,
	"desc":"SUCCESS",
	"result": [{
		"orderId": "22bb3e7b-e1f1-4c32-a646-6e0611cf78ed",
		"dataDemander": "did:ont:AR9cMgFaPNDw82v1aGjmB18dfA4BvtmoeN",
		"dataIdList": ["6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb7875b4b"],
		"buyDate": "2019-3-20",
		"state": "deliveredOnchain"
	}]
	}

Field_Name	Type	Description
action	String	动作标志
version	String	版本号
error	int	错误码
desc	String	成功为SUCCESS，失败为错误描述
result	String	成功返回orderList，失败返回""

数据加密

提供 ONTID，kid 以及 password。
从区块链上查询指定公钥 pk。
使用公钥 pk 对数据加密。

url：/api/v1/datadealer/tools/encrypt
method：POST

请求：

{
  "ONTID": "did:ont:AR9cMgFaPNDw82v1aGjmB18dfA4BvtmoeN",
  "kid": 2,
  "message": "http://data1.com"
}

Field_Name	Type	Description
ONTID	String	本体身份标识
kid	Int	公钥编号
message	String	待加密数据

响应：

{
	"action":"encrypt",
	"version":"v1",
	"error":0,
	"desc":"SUCCESS",
	"result": "5dbdbbecb8243e948e7dc6f3cd9bed96"
}

Field_Name	Type	Description
action	String	动作标志
version	String	版本号
error	int	错误码
desc	String	成功为SUCCESS，失败为错误描述
result	String	成功返回解密数据，失败返回""

数据解密

提供数据提供方的 ONTID，kid。
从区块链上查询指定公钥。
从 KeyStore 中匹配对应的私钥。
根据 password 对私钥进行解密，得到解密后的私钥 sk。
使用私钥 sk 对数据进行解密。

url：/api/v1/datadealer/tools/decrypt
method：POST

请求：

{
  "ONTID": "did:ont:AR9cMgFaPNDw82v1aGjmB18dfA4BvtmoeN",
  "kid": 2,
  "cipher": "5dbdbbecb8243e948e7dc6f3cd9bed96",
  "password": "password"
}

Field_Name	Type	Description
ONTID	String	ONT ID
password	String	加密私钥的密码
cipher	String	待解密的密文

响应：

{
	"action":"decrypt",
	"version":"v1",
	"error":0,
	"desc":"SUCCESS",
	"result": "http://data1.com"
}

Field_Name	Type	Description
action	String	动作标志
version	String	版本号
error	int	错误码
desc	String	成功为SUCCESS，失败为错误描述
result	String	成功返回解密数据，失败返回""

Name		Name	Last commit message	Last commit date
Latest commit History 63 Commits
.idea		.idea
config		config
img		img
sql		sql
src		src
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
data-dealer.iml		data-dealer.iml
pom.xml		pom.xml
wallet.json		wallet.json

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Data Dealer

简介

接口规范

账户管理

数据需求方注册

数据提供方注册

登录

数据需求方

查询订单

购买数据

取消订单

获取数据提取信息

数据提供方

发送加密数据提取信息

收取通证

工具接口

查询订单

数据加密

数据解密

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

Data Dealer

简介

接口规范

账户管理

数据需求方注册

数据提供方注册

登录

数据需求方

查询订单

购买数据

取消订单

获取数据提取信息

数据提供方

发送加密数据提取信息

收取通证

工具接口

查询订单

数据加密

数据解密

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages