区块链金融API
2017-07-23 本文已影响0人
kauchy
区块链API
版本:
v0.1
日期:
2017年05月27日
目录
[TOC]
消息字段
标
//omsId，"LOAN_"+"OMSID_"+时间戳
String id
//借款标题
String titlec
//OMSID
String omsId
//oms name
String omsName
//OMS钱包地址
String omsWalletAddress
//借款人姓名
String borrowerName
//借款人电话
String borrowerPhone
//借款人地址
String borrowerAddress
//借款人身份证号
String borrowerIdCardNumber
//借款人钱包地址
String borrowerWalletAddress
//借款人说明
String borrowerDescription
//10 发售中;20 已满额(待扣投资款);30 已流标;40 待还款;50 待扣还款？;60 已结清;70 已逾期？
int status
//计息方式,暂只支持按年
int rateTimeUnit
//利率（年）
Double rate
//借款额
Double amount
//oms收费,借款人收到资金=amount-omsFee
Double omsFee
//利息总额
Double interestAmount
//还款总额=借款额+利息总额
Double refundAmount
//审批状态，未使用
int approveStatus
//审批时间，未使用
Timestamp approveTime
//期限时间单位，暂时未启用
int periodTimeUnit
//期限，天
int period
//还款方式，暂时只支持到期全款支付
int refundType
//筹标截止时间
Timestamp deadTime
//起息时间，标满开始计息
Timestamp startTime
//计划还款时间，startTime+period
Timestamp refundTime
//实际还款时间
Timestamp realRefoundTime
//已认购金额
Double enterAmount
//已认购笔数
int enterCount
//已还款
Boolean isRefunded
//序列号，未使用
String serialNumber
//合同号,未使用
String contractCode
//合同描述,未使用
String contractDesc
//起投金额
Double startInvestAmount
//递增金额
Double increaseInvestAmount
//区块链txid
String chainTxId
//区块号
String blockId
//描述
String description
//资金用途
String fundUsage
//还款来源
String repaySource
//征信
String creditInformation
//担保信息
String guaranteeInformation
用户
//用户id
String id
//手机号,登录用户
String mobilePhone
//密码
String password
//姓名
String realName
//注册时间
Timestamp registerTime
//身份证号
String idCardNumber
//实名认证状态。0 创建;10 已实名验证;20 已导入钱包
int authStatus
//实名认证时间
Timestamp authTime
//钱包地址
String walletAddress
//钱包pubKey
String walletPubKey
//总资产
Double totalAmount
//可用资产
Double usableAmount
//冻结金额
Double frozenAmount
//投资总收益
Double interestAmount
//投资总笔数
int loanCount
//投资总金额
Double loanAmount
//已回收笔数
int recoveredCount
//已回收总金额
Double recoveredAmount
//已回收的本金
Double recoveredPrincipal
//已回收收益
Double recoveredInterest
//待回收笔数
int unRecoveredCount
//待回收总额
Double unrecoveredAmount
//待回收的本金
Double unRecoveredPrincipal
//待回收的收益
Double unRecoveredInterest
投资
//"INVEST_"+"marketId_"+"13位时间戳"
String id
//标ID
String loanId
//oms id
String omsId
//market Id
String marketId
//投资人id
String investorId
//投资人身份证号
String investorIdCardNumber
//投资人钱包地址
String inverstorWalletAddress
//投资金额
Double amount
//预期收益
Double interestAmount
//回款总金额
Double refundAmount
//10,投资提交20,资金已冻结30,取消投资40,待扣投资款50,待回款60,已还款70,已逾期？
int status
//创建时间
Timestamp createTime
//开始计息时间
Timestamp startTime
//到期时间
Timestamp refoundTime
//实际回款时间
Timestamp realRefoundTime
//区块链txid
String chainTxId
//区块号
String blockId
API
1 OMS
1.1 借款上链
URL
https://apis.qianbao.com/jiedai/v1/oms/loan
Method
POST
Header
Content-type: application/x-www-form-urlencoded;charset=utf-8
RequestBody
"title": "天津买房首付",
"borrowerName": "zz",
"borrowerIdCardNumber": "10100000000000000",
"borrowerWalletAddress": "walet101",
"borrowerPhone": "13888888888",
"borrowerAddress": "北京市朝阳区",
"borrowerDescription": "一个好人",
"amount": 500000,
"omsFee": 5000,
"rate": 0.1,
"period": 90,
"interestAmount": 12328.77,
"deadTime": "2017-07-31 23:59:59",
"startInvestAmount": 10000,
"increaseInvestAmount": 1000,
"description": "good",
"fundUsage": "买房",
"repaySource": "工资",
"creditInformation": "very good",
"guaranteeInformation": "赵老板"
ReponseBody
{
"status": "20000551",
"message": "OK"
}
1.2 查询借款列表
URL
https://apis.qianbao.com/jiedai/v1/oms/loans?status={status}
status参数可选
Method
GET
ReponseBody:
{
"status": "20000551",
"message": "OK",
"result": [
{
"id": "LOAN_oms001_1500606584559",
"title": "天津买房首付",
"omsId": "oms001",
"omsName": "乾元OMS",
"omsWalletAddress": "wallet_Oms001",
"borrowerName": "zz",
"borrowerPhone": "13888888888",
"borrowerAddress": "北京市朝阳区",
"borrowerIdCardNumber": "10100000000000000",
"borrowerWalletAddress": "walet101",
"borrowerDescription": "一个好人",
"status": 10,
"rateTimeUnit": 2,
"rate": 0.1,
"amount": 500000,
"omsFee": 5000,
"interestAmount": 12328.77,
"refundAmount": 512328.77,
"approveStatus": 3,
"approveTime": 1500606585000,
"periodTimeUnit": 1,
"period": 90,
"refundType": 0,
"deadTime": 1501516799000,
"enterAmount": 0,
"enterCount": 0,
"isRefunded": false,
"startInvestAmount": 10000,
"increaseInvestAmount": 1000,
"description": "good",
"fundUsage": "买房",
"repaySource": "工资",
"creditInformation": "very good",
"guaranteeInformation": "赵老板"
},
{
"id": "LOAN_oms001_1500606668343",
"title": "登录火星",
"omsId": "oms001",
"omsName": "乾元OMS",
"omsWalletAddress": "wallet_Oms001",
"borrowerName": "gx",
"borrowerPhone": "13888888888",
"borrowerAddress": "北京市朝阳区",
"borrowerIdCardNumber": "10100000000000000",
"borrowerWalletAddress": "walet101",
"borrowerDescription": "一个好人",
"status": 10,
"rateTimeUnit": 2,
"rate": 0.1,
"amount": 500000,
"omsFee": 5000,
"interestAmount": 12328.77,
"refundAmount": 512328.77,
"approveStatus": 3,
"approveTime": 1500606669000,
"periodTimeUnit": 1,
"period": 90,
"refundType": 0,
"deadTime": 1501516799000,
"enterAmount": 0,
"enterCount": 0,
"isRefunded": false,
"startInvestAmount": 10000,
"increaseInvestAmount": 1000,
"description": "good",
"fundUsage": "火星",
"repaySource": "火星采矿",
"creditInformation": "very good",
"guaranteeInformation": "赵老板"
}
]
}
1.3 查询借款
URL
https://apis.qianbao.com/jiedai/v1/oms/loan/{id}
Method
GET
ReponseBody:
{
"status": "20000551",
"message": "OK",
"result": {
"id": "LOAN_oms001_1500606584559",
"title": "天津买房首付",
"omsId": "oms001",
"omsName": "乾元OMS",
"omsWalletAddress": "wallet_Oms001",
"borrowerName": "zz",
"borrowerPhone": "13888888888",
"borrowerAddress": "北京市朝阳区",
"borrowerIdCardNumber": "10100000000000000",
"borrowerWalletAddress": "walet101",
"borrowerDescription": "一个好人",
"status": 10,
"rateTimeUnit": 2,
"rate": 0.1,
"amount": 500000,
"omsFee": 5000,
"interestAmount": 12328.77,
"refundAmount": 512328.77,
"approveStatus": 3,
"approveTime": 1500606585000,
"periodTimeUnit": 1,
"period": 90,
"refundType": 0,
"deadTime": 1501516799000,
"enterAmount": 0,
"enterCount": 0,
"isRefunded": false,
"startInvestAmount": 10000,
"increaseInvestAmount": 1000,
"description": "good",
"fundUsage": "买房",
"repaySource": "工资",
"creditInformation": "very good",
"guaranteeInformation": "赵老板"
}
}
参数错误
{
"message": "借款不存在",
"status": "40400551"
}
2 p2p
2.1 查询借款列表
URL
https://apis.qianbao.com/jiedai/v1/p2p/loans?status={status}
status参数可选
Method
GET
ReponseBody:
参考1.2
2.2 查询借款
URL
curl https://apis.qianbao.com/jiedai/v1/p2p/loans/{id}
Method
GET
ReponseBody:
参考1.3
2.3 注册验证码
URL
https://apis.qianbao.com/jiedai/v1/p2p/register/sms?mobilePhone={mobilePhone}
Method
GET
ReponseBody:
{
"status": "20000551",
"message": "OK"
}
2.4 注册
URL
https://apis.qianbao.com/jiedai/v1/p2p/register?smsCode=?
Method
POST
Header
Content-type: application/x-www-form-urlencoded;charset=utf-8
RequestBody
"mobilePhone":"18610274382"
"password":"123"
ReponseBody:
{
"status": "20000551",
"message": "OK",
"result": {
"token": "667d6b13a2314d5797722adca31aaa34",
"investorId": "market001_investor_1500610469952"
}
}
2.5 登录
URL
https://apis.qianbao.com/jiedai/v1/p2p/login
Method
POST
Header
Content-type: application/x-www-form-urlencoded;charset=utf-8
RequestBody
"mobilePhone":"18610274382"
"password":"123"
ReponseBody:
{
"status": "20000551",
"message": "OK",
"result": {
"token": "7f9b75c28a264eac8582f3b58c02e3d1",
"investorId": "market001_investor_1500610469952"
}
}
2.6 退出登录
URL
https://apis.qianbao.com/jiedai/v1/p2p/logout?QB_AUTH_TOKEN={token}
Method
DELETE
ReponseBody:
{
"status": "20000551",
"message": "OK"
}
2.7 实名认证
URL
https://apis.qianbao.com/jiedai/v1/p2p/investor/auth?QB_AUTH_TOKEN={token}
Method
PUT
Header
"Content-type: application/json;charset=utf-8"
RequestBody
"realName":"高翔"
"idCardNumber":"42012345678901234"
ReponseBody:
{
"status": "20000551",
"message": "OK",
"result": {
"id": "market001_investor_1500610469952",
"mobilePhone": "18610274382",
"realName": "高翔",
"registerTime": 1500610470000,
"idCardNumber": "42012345678901234",
"authStatus": 10,
"authTime": 1500610750014,
"totalAmount": 0,
"usableAmount": 0,
"frozenAmount": 0,
"interestAmount": 0,
"loanCount": 0,
"loanAmount": 0,
"recoveredCount": 0,
"recoveredAmount": 0,
"recoveredPrincipal": 0,
"recoveredInterest": 0,
"unRecoveredCount": 0,
"unrecoveredAmount": 0,
"unRecoveredPrincipal": 0,
"unRecoveredInterest": 0
}
}
2.8 导入钱包
URL
https://apis.qianbao.com/jiedai/v1/p2p/investor/wallet?QB_AUTH_TOKEN={token}
Method
PUT
Header
"Content-type: application/json;charset=utf-8"
RequestBody
"walletAddress":"Wallet18610274382"
"walletPubKey":"WalletPubKey001"
ReponseBody:
{
"status": "20000551",
"message": "OK",
"result": {
"id": "market001_investor_1500610469952",
"mobilePhone": "18610274382",
"realName": "高翔",
"registerTime": 1500610470000,
"idCardNumber": "42012345678901234",
"authStatus": 20,
"authTime": 1500610750000,
"walletAddress": "Wallet18610274382",
"totalAmount": 0,
"usableAmount": 0,
"frozenAmount": 0,
"interestAmount": 0,
"loanCount": 0,
"loanAmount": 0,
"recoveredCount": 0,
"recoveredAmount": 0,
"recoveredPrincipal": 0,
"recoveredInterest": 0,
"unRecoveredCount": 0,
"unrecoveredAmount": 0,
"unRecoveredPrincipal": 0,
"unRecoveredInterest": 0
}
}
2.9 当前用户详细信息
URL
https://apis.qianbao.com/jiedai/v1/p2p/investor?QB_AUTH_TOKEN={token}
Method
GET
ReponseBody:
{
"status": "20000551",
"message": "OK",
"result": {
"id": "market001_investor_1500610469952",
"mobilePhone": "18610274382",
"realName": "高翔",
"registerTime": 1500610470000,
"idCardNumber": "42012345678901234",
"authStatus": 20,
"authTime": 1500610750000,
"walletAddress": "Wallet18610274382",
"totalAmount": 0,
"usableAmount": 0,
"frozenAmount": 0,
"interestAmount": 0,
"loanCount": 0,
"loanAmount": 0,
"recoveredCount": 0,
"recoveredAmount": 0,
"recoveredPrincipal": 0,
"recoveredInterest": 0,
"unRecoveredCount": 0,
"unrecoveredAmount": 0,
"unRecoveredPrincipal": 0,
"unRecoveredInterest": 0
}
}
2.10 投资
URL
https://apis.qianbao.com/jiedai/v1/p2p/invest?QB_AUTH_TOKEN={token}
Method
POST
Header
"Content-type: application/json;charset=utf-8"
RequestBody
"loanId":"LOAN_oms001_1500186027844"
"amount":400000
ReponseBody:
{
"status": "20000551",
"message": "OK"
}
异常
{
"message": "可投金额不足",
"status": "40000551"
}
2.11 用户投资列表
URL
curl https://apis.qianbao.com/jiedai/v1/p2p/invests?status={status}&QB_AUTH_TOKEN={token}
status参数可选
Method
GET
ReponseBody:
{
"status": "20000551",
"message": "OK",
"result": [
{
"id": "INVEST_market001_1500611289445",
"loanId": "LOAN_oms001_1500611158732",
"omsId": "oms001",
"marketId": "market001",
"investorId": "market001_investor_1500610469952",
"investorIdCardNumber": "42012345678901234",
"inverstorWalletAddress": "Wallet18610274382",
"amount": 100000,
"interestAmount": 2465.76,
"refundAmount": 102465.76,
"status": 10,
"createTime": 1500611289000,
"startTime": 1500611339000,
"refoundTime": 1508387339000
},
{
"id": "INVEST_market001_1500611339482",
"loanId": "LOAN_oms001_1500611158732",
"omsId": "oms001",
"marketId": "market001",
"investorId": "market001_investor_1500610469952",
"investorIdCardNumber": "42012345678901234",
"inverstorWalletAddress": "Wallet18610274382",
"amount": 400000,
"interestAmount": 9863.01,
"refundAmount": 409863.01,
"status": 10,
"createTime": 1500611339000,
"startTime": 1500611339000,
"refoundTime": 1508387339000
}
]
}
2.12 查询指定投资
URL
curl https://apis.qianbao.com/jiedai/v1/p2p/invest/{id}?QB_AUTH_TOKEN={token}
Method
GET
ReponseBody:
{
"status": "20000551",
"message": "OK",
"result": {
"id": "INVEST_market001_1500611289445",
"loanId": "LOAN_oms001_1500611158732",
"omsId": "oms001",
"marketId": "market001",
"investorId": "market001_investor_1500610469952",
"investorIdCardNumber": "42012345678901234",
"inverstorWalletAddress": "Wallet18610274382",
"amount": 100000,
"interestAmount": 2465.76,
"refundAmount": 102465.76,
"status": 10,
"createTime": 1500611289000,
"startTime": 1500611339000,
"refoundTime": 1508387339000
}
}
