票交所區(qū)塊鏈POC api

說明

以下api說明中{xxx}表示變量/參數(shù)
API URL都是https://sit-blockchain.qianbao.com/chaincode
所有請求和返回均為json
請求格式

{
  "jsonrpc": "2.0",
  "method": "{method}",
  "params": {
      "type": 1,
      "chaincodeID":{
          "name":"{chaincodeId}"
      },
      "ctorMsg": {
         "function":"{function}",
         "args":["{參數(shù)1}","{參數(shù)2}","{參數(shù)3}"...]
      }
  },
  "id":{id}
}

{method} query/invoke
{chaincodeId} 測試前提供
{function} 實際操作，見具體API
{args} 調(diào)用參數(shù)娃承，見具體API
返回格式

{
  "jsonrpc": "2.0",
  "result": {
    "status": "{status}",
    "message": "{body}"
  },
  "id":{id}
}

所有invoke方法調(diào)用都是異步提交方式武花，返回結(jié)果只有事務(wù)TXID。
status ok不代表執(zhí)行成功，執(zhí)行結(jié)果無法直接查看温自，只能通過查看world state狀態(tài)查看調(diào)用結(jié)果

{
  "jsonrpc": "2.0",
  "result": {
    "status": "OK",
    "message": "{TXID}"
  },
  "id":{id}
}

{id}:數(shù)字,序號,暫無意義,下同

目前fabric無法查詢到返回結(jié)果已维，demo階段將執(zhí)行結(jié)果放入world state供查詢。

request

{
  "jsonrpc": "2.0",
  "method": "query",
  "params": {
      "type": 1,
      "chaincodeID":{
          "name":"{chaincodeId}"
      },
      "ctorMsg": {
         "function":"result",
         "args":["{TXID}"]
      }
  },
  "id":{id}
}

response

{
  "jsonrpc": "2.0",
  "result": {
    "status": "OK",
    "message": "{\"message\":\"OK\",\"result\":{json}/"{string}",\"status\":\"20000000\",\"success\":true}"
  },
  "id":{id}
}

{status}="20000000"或者{success}=true為成功

result為結(jié)果json

api

1.交易所

字段

marketId 交易所id,demo階段只需要創(chuàng)建一個票交所阔墩，所有交易都在一個票交所交易
address 地址
name 名稱
priKey 私鑰嘿架。簽名使用，demo不做數(shù)字簽名啸箫，只簡單比較私鑰耸彪。值為pri-{marketId}
pubKey 公鑰。值為pub-{marketId}

1.1創(chuàng)建交易所

request

{
  "jsonrpc": "2.0",
  "method": "invoke",
  "params": {
      "type": 1,
      "chaincodeID":{
          "name":"{chaincodeId}"
      },
      "ctorMsg": {
         "function":"market.create",
         "args":["{\"marketId\":\"{marketId}\",\"address\":\"{地址}\",\"name\":\"{name}\"}"]
      }
  },
  "id":{id}
}

response

{
  "jsonrpc": "2.0",
  "result": {
    "status": "OK",
    "message": "{TXID}"
  },
  "id":{id}
}

該返回并不代表創(chuàng)建成功忘苛，見說明

1.2查詢交易所

request

{
  "jsonrpc": "2.0",
  "method": "query",
  "params": {
      "type": 1,
      "chaincodeID":{
          "name":"{chaincodeId}"
      },
      "ctorMsg": {
         "function":"market",
         "args":["{marketId}"]
      }
  },
  "id":{id}
}

response

{
  "jsonrpc": "2.0",
  "result": {
    "status": "OK",
    "message": "{\"message\":\"OK\",\"result\":\"{\"address\":\"{address}\",\"marketId\":\"{market}\",\"name\":\"{name}\",\"priKey\":\"{priKey}\",\"pubKey\":\"{pubKey}\"}\",\"status\":\"20000000\",\"success\":true}"
  },
  "id": 0
}

demo ok

{
  "jsonrpc": "2.0",
  "result": {
    "status": "OK",
    "message": "{\"message\":\"OK\",\"result\":\"{\"address\":\"beijing\",\"marketId\":\"qianbao\",\"name\":\"qianbao\",\"priKey\":\"pri-qianbao\",\"pubKey\":\"pub-qianbao\"}\",\"status\":\"20000000\",\"success\":true}"
  },
  "id": 0
}

demo-not found

{
  "jsonrpc": "2.0",
  "result": {
    "status": "OK",
    "message": "{\"message\":\"market not found!\",\"status\":\"40400000\",\"success\":false}"
  },
  "id": 0
}

2.用戶

userId 為公司或組織業(yè)務(wù)ID
marketId 所屬票交所
type 1:spv,可以做資產(chǎn)打包合約;2:普通票據(jù)持有者
market-priKey 必須為票交所對應(yīng)priKey,用戶創(chuàng)建只能通過票交所上鏈蝉娜，通過該字段檢查來模擬票交所簽名
address 地址
businessLicense 營業(yè)執(zhí)照
organizationCodeCertificate 稅務(wù)登記證
taxRegistrationCertificate 組織機構(gòu)代碼證
priKey 用戶私鑰唱较。demo不做數(shù)字簽名，只簡單比較私鑰召川。值為pri-{userId}
pubKey 用戶公鑰南缓。值為pub-{userId}

2.1用戶上鏈

request

{
  "jsonrpc": "2.0",
  "method": "invoke",
  "params": {
      "type": 1,
      "chaincodeID":{
          "name":"{chaincodeId}"
      },
      "ctorMsg": {
         "function":"user.create",
         "args":["{\"name\":\"{name}\",\"address\":\"{address}\",\"marketId\":\"{marketId}\",\"type\":{type},\"userId\":\"{userId}\",\"businessLicense\":\"{businessLicense}\",\"organizationCodeCertificate\":\"{organizationCodeCertificate}\",\"taxRegistrationCertificate\":\"{organizationCodeCertificate}\"}","{market-priKey"]
      }
  },
  "id":{id}
}

response

{
  "jsonrpc": "2.0",
  "result": {
    "status": "OK",
    "message": "{TXID}"
  },
  "id":{id}
}

該返回并不代表創(chuàng)建成功，見說明

2.2查詢用戶

request

{
  "jsonrpc": "2.0",
  "method": "query",
  "params": {
      "type": 1,
      "chaincodeID":{
          "name":"{chaincodeId}"
      },
      "ctorMsg": {
         "function":"user",
         "args":["userId"]
      }
  },
  "id":{id}
}

response demo

{
  "jsonrpc": "2.0",
  "result": {
    "status": "OK",
    "message": "{\"message\":\"OK\",\"result\":\"{\"address\":\"beijing\",\"businessLicense\":\"xxxxx\",\"marketId\":\"qianbao\",\"name\":\"zhangzheng\",\"organizationCodeCertificate\":\"xxxxxx\",\"priKey\":\"pri-zz\",\"pubKey\":\"pub-zz\",\"taxRegistrationCertificate\":\"xxxxxx\",\"type\":1,\"userId\":\"zz\"}\",\"status\":\"20000000\",\"success\":true}"
  },
  "id": 0
}

not found

{
  "jsonrpc": "2.0",
  "result": {
    "status": "OK",
    "message": "{\"message\":\"user not found!\",\"status\":\"40400000\",\"success\":false}"
  },
  "id": 0
}

3.票據(jù)

userId 用戶id
marketId 所屬票交所
billId 票據(jù)id
type 1:紙銀;2:紙商
status 10.持有荧呐，20.交易中汉形，30.資產(chǎn)，40.已承兌坛增。允許狀態(tài)轉(zhuǎn)換:持有->交易中;交易中->資產(chǎn);持有->已承兌;交易中->持有;資產(chǎn)->已承兌
amount 面值
startDate yyyyMMdd
endDate yyyyMMdd
bank 銀行
bankAddress 銀行地址
billPackage 資產(chǎn)包获雕。資產(chǎn)打包后改字段有值
transactions 歷史交易id。字符串數(shù)組

3.1 票據(jù)上鏈

request

{
  "jsonrpc": "2.0",
  "method": "invoke",
  "params": {
      "type": 1,
      "chaincodeID":{
          "name":"{chaincodeId}"
      },
      "ctorMsg": {
         "function":"bill.create",
         "args":["{\"billId\":\"{billId}\",\"type\":{type},\"marketId\":\"{marketId}\",\"userId\":\"{userId}\",\"amount\":{amout},\"startDate\":\"{startDate}\",\"endDate\":\"{endDate}\",\"bank\":\"{bank}\",\"bankAddress\":\"{bankAddress}\"}","market-priKey","user-priKey"]
      }
  },
  "id":{id}
}

response

{
  "jsonrpc": "2.0",
  "result": {
    "status": "OK",
    "message": "{TXID}"
  },
  "id":{id}
}

該返回并不代表創(chuàng)建成功收捣，見說明

3.2 票據(jù)查詢

request

{
  "jsonrpc": "2.0",
  "method": "query",
  "params": {
      "type": 1,
      "chaincodeID":{
          "name":"{chaincodeId}"
      },
      "ctorMsg": {
         "function":"bill",
         "args":["{billId}"]
      }
  },
  "id":{id}
}

response demo

{
  "jsonrpc": "2.0",
  "result": {
    "status": "OK",
    "message": "{\"message\":\"OK\",\"result\":\"{\"amount\":1000000,\"billId\":\"bill002\",\"endDate\":\"20180107\",\"startDate\":\"20180107\",\"bank\":\"ccbc\",\"bankAddress\":\"beijing\",\"marketId\":\"qianbao\",\"startDate\":\"20170107\",\"status\":10,\"transactions\":[\"5fe73654-dd53-433b-993f-62435ed3eeb4\",\"39a06dc2-f6a3-45d1-80c8-e42e5105afad\"],\"type\":1,\"userId\":\"gaoxiang\"}\",\"status\":\"20000000\",\"success\":true}"
  },
  "id": 0
}

not found

{
  "jsonrpc": "2.0",
  "result": {
    "status": "OK",
    "message": "{\"message\":\"bill not found!\",\"status\":\"40400000\",\"success\":false}"
  },
  "id": 0
}

4.交易

transactionId 交易ID,使用交易創(chuàng)建返回的區(qū)塊鏈TXID作為交易ID届案。
billId 票據(jù)Id
buyer 買方Id
buyerMarket 買方票交所Id
seller 賣方Id
sellerMarket 賣方票交所Id
buyerStatus 買方狀態(tài)，只能買方修改罢艾。0,交易中;1,完成;2,取消
sellerStatus 賣方狀態(tài)楣颠，只能賣方修改。0,交易中;1,完成;2,取消
status 交易狀態(tài)咐蚯。0,交易中;1,完成（交易雙方狀態(tài)都是完成）;2,取消（交易雙方狀態(tài)都是取消）
createTime 交易創(chuàng)建時間

4.1交易創(chuàng)建

request

{
  "jsonrpc": "2.0",
  "method": "invoke",
  "params": {
      "type": 1,
      "chaincodeID":{
          "name":"{chaincodeId}"
      },
      "ctorMsg": {
         "function":"transaction.create",
         "args":["{\"billId\":\"{billId}\",\"sellerMarket\":\"{sellerMarket}\",\"seller\":\"{seller}\",\"buyerMarket\":\"{buyerMarket}\",\"buyer\":\"{buyer}\",\"price\":{price},\"createTime\":{createTime}}","{sellerMarket-priKey}","{seller-priKey}"]
      }
  },
  "id":{id}
}

response

{
  "jsonrpc": "2.0",
  "result": {
    "status": "OK",
    "message": "{TXID}"
  },
  "id":{id}
}

返回消息中的TXID直接作為票據(jù)交易的transactionId,該返回并不代表交易創(chuàng)建成功童漩，見說明。

交易創(chuàng)建成功春锋，票據(jù)狀態(tài)變更為交易中（20）矫膨。

4.2買方確認

request

{
  "jsonrpc": "2.0",
  "method": "invoke",
  "params": {
      "type": 1,
      "chaincodeID":{
          "name":"{chaincodeId}"
      },
      "ctorMsg": {
         "function":"transaction.buyer.confirm",
         "args":["transactionId","{buyerMarket-priKey}","{buyer-priKey}"]
      }
  },
  "id":{id}
}

response

{
  "jsonrpc": "2.0",
  "result": {
    "status": "OK",
    "message": "{TXID}"
  },
  "id":{id}
}

該返回并不代表交易確認成功，見說明期奔。
買方確認成功時侧馅，買方狀態(tài)變更為完成（1）。若賣方狀態(tài)為完成（1）呐萌。則交易狀態(tài)變更為完成（1）馁痴，同時修改票據(jù)所有人，及票據(jù)狀態(tài)（10）肺孤。

4.3賣方確認

request

{
  "jsonrpc": "2.0",
  "method": "invoke",
  "params": {
      "type": 1,
      "chaincodeID":{
          "name":"{chaincodeId}"
      },
      "ctorMsg": {
         "function":"transaction.seller.confirm",
         "args":["transactionId","{sellerMarket-priKey}","{seller-priKey}"]
      }
  },
  "id":{id}
}

response

{
  "jsonrpc": "2.0",
  "result": {
    "status": "OK",
    "message": "{TXID}"
  },
  "id":{id}
}

該返回并不代表交易確認成功罗晕，見說明。

賣方確認成功時赠堵，賣方狀態(tài)變更為完成（1）小渊。若買方狀態(tài)為完成（1）。則交易狀態(tài)變更為完成（1）茫叭，同時修改票據(jù)所有人酬屉，及票據(jù)狀態(tài)（10）。

4.4買方取消

request

{
  "jsonrpc": "2.0",
  "method": "invoke",
  "params": {
      "type": 1,
      "chaincodeID":{
          "name":"{chaincodeId}"
      },
      "ctorMsg": {
         "function":"transaction.buyer.cancle",
         "args":["transactionId","{buyerMarket-priKey}","{buyer-priKey}"]
      }
  },
  "id":{id}
}

response

{
  "jsonrpc": "2.0",
  "result": {
    "status": "OK",
    "message": "{TXID}"
  },
  "id":{id}
}

該返回并不代表交易取消成功杂靶，見說明梆惯。

買方取消成功時，買方狀態(tài)變更為取消（2）吗垮。若賣方狀態(tài)為取消（2）垛吗。則交易狀態(tài)變更為取消（2），同時修改票據(jù)狀態(tài)（10）烁登。

4.5賣方取消

request

{
  "jsonrpc": "2.0",
  "method": "invoke",
  "params": {
      "type": 1,
      "chaincodeID":{
          "name":"{chaincodeId}"
      },
      "ctorMsg": {
         "function":"transaction.seller.cancle",
         "args":["transactionId","{sellerMarket-priKey}","{seller-priKey}"]
      }
  },
  "id":{id}
}

response

{
  "jsonrpc": "2.0",
  "result": {
    "status": "OK",
    "message": "{TXID}"
  },
  "id":{id}
}

該返回并不代表交易取消成功怯屉，見說明。

賣方取消成功時饵沧，賣方狀態(tài)變更為取消（2）锨络。若買狀態(tài)為取消（2）。則交易狀態(tài)變更為取消（2）狼牺，同時修改票據(jù)狀態(tài)（10）羡儿。

4.5交易查詢

request

{
  "jsonrpc": "2.0",
  "method": "query",
  "params": {
      "type": 1,
      "chaincodeID":{
          "name":"{chaincodeId}"
      },
      "ctorMsg": {
         "function":"transaction",
         "args":["{transactionId}"]
      }
  },
  "id":{id}
}

5.資產(chǎn)

packageId 資產(chǎn)ID,使用資產(chǎn)上鏈返回的區(qū)塊鏈TXID作為資產(chǎn)ID。
marketId 票交所
userId 資產(chǎn)所有人是钥，只有SPV才能打包資產(chǎn)
name 資產(chǎn)名稱
endDate 資產(chǎn)到期日yyyyMMdd
status 資產(chǎn)狀態(tài)掠归。10,資產(chǎn);20,兌付中;30,已兌付
startDate yyyyMMdd
price 資產(chǎn)價格,double
billIds 票據(jù)id。字符串數(shù)組

5.1資產(chǎn)打包上鏈

request

{
  "jsonrpc": "2.0",
  "method": "invoke",
  "params": {
      "type": 1,
      "chaincodeID":{
          "name":"{chaincodeId}"
      },
      "ctorMsg": {
         "function":"package.create",
         "args":["{\"userId\":\"{userId}\",\"marketId\":\"{marketId}\",\"name\":\"{name}\",\"endDate\":\"{endDate}\",\"price\":{price},\"billIds\":[\"{billId}",\"{billId}\"]}","{market-priKey}","{user-priKey}"]
      }
  },
  "id":{id}
}

response

{
  "jsonrpc": "2.0",
  "result": {
    "status": "OK",
    "message": "{TXID}"
  },
  "id":{id}
}

返回消息中的TXID直接作為資產(chǎn)的packageId,該返回并不代表資產(chǎn)創(chuàng)建成功悄泥，見說明虏冻。

資產(chǎn)打包會檢查票據(jù)持有人及priKey。

資產(chǎn)創(chuàng)建成功弹囚，票據(jù)狀態(tài)變更為資產(chǎn)（30）厨相。

5.2資產(chǎn)狀態(tài)更新

request

{
  "jsonrpc": "2.0",
  "method": "invoke",
  "params": {
      "type": 1,
      "chaincodeID":{
          "name":"{chaincodeId}"
      },
      "ctorMsg": {
         "function":"package.create",
         "args":["{package}","{market-priKey}","{user-priKey}","{status}"]
      }
  },
  "id":{id}
}

{status}只能為"20"或者"30"

response

{
  "jsonrpc": "2.0",
  "result": {
    "status": "OK",
    "message": "{TXID}"
  },
  "id":{id}
}

該返回并不代表資產(chǎn)狀態(tài)更新成功，見說明鸥鹉。

資產(chǎn)狀態(tài)更新為已兌付（30）時蛮穿，票據(jù)狀態(tài)變更為已兌付（40）。

5.3資產(chǎn)查詢

request

{
  "jsonrpc": "2.0",
  "method": "query",
  "params": {
      "type": 1,
      "chaincodeID":{
          "name":"{chaincodeId}"
      },
      "ctorMsg": {
         "function":"package",
         "args":["{package}"]
      }
  },
  "id":{id}
}

最后編輯于：2017.12.05 06:16:44

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者

人面猴
序言：七十年代末宋舷，一起剝皮案震驚了整個濱河市绪撵，隨后出現(xiàn)的幾起案子，更是在濱河造成了極大的恐慌祝蝠，老刑警劉巖音诈，帶你破解...
沈念sama閱讀 212,718評論 6贊 492
死咒
序言：濱河連續(xù)發(fā)生了三起死亡事件，死亡現(xiàn)場離奇詭異绎狭，居然都是意外死亡细溅，警方通過查閱死者的電腦和手機，發(fā)現(xiàn)死者居然都...
沈念sama閱讀 90,683評論 3贊 385
救了他兩次的神仙讓他今天三更去死
文/潘曉璐我一進店門儡嘶，熙熙樓的掌柜王于貴愁眉苦臉地迎上來喇聊，“玉大人，你說我怎么就攤上這事蹦狂∈睦椋” “怎么了朋贬？”我有些...
開封第一講書人閱讀 158,207評論 0贊 348
道士緝兇錄：失蹤的賣姜人
文/不壞的土叔我叫張陵，是天一觀的道長窜骄。經(jīng)常有香客問我锦募，道長，這世上最難降的妖魔是什么邻遏？我笑而不...
開封第一講書人閱讀 56,755評論 1贊 284
?港島之戀（遺憾婚禮）
正文為了忘掉前任糠亩，我火速辦了婚禮，結(jié)果婚禮上准验，老公的妹妹穿的比我還像新娘赎线。我一直安慰自己，他們只是感情好糊饱，可當我...
茶點故事閱讀 65,862評論 6贊 386
惡毒庶女頂嫁案：這布局不是一般人想出來的
文/花漫我一把揭開白布垂寥。她就那樣靜靜地躺著，像睡著了一般济似。火紅的嫁衣襯著肌膚如雪矫废。梳的紋絲不亂的頭發(fā)上，一...
開封第一講書人閱讀 50,050評論 1贊 291
城市分裂傳說
那天砰蠢，我揣著相機與錄音蓖扑，去河邊找鬼。笑死台舱，一個胖子當著我的面吹牛律杠，可吹牛的內(nèi)容都是我干的。我是一名探鬼主播竞惋，決...
沈念sama閱讀 39,136評論 3贊 410
雙鴛鴦連環(huán)套：你想象不到人心有多黑
文/蒼蘭香墨我猛地睜開眼柜去，長吁一口氣：“原來是場噩夢啊……” “哼！你這毒婦竟也來了拆宛？” 一聲冷哼從身側(cè)響起嗓奢，我...
開封第一講書人閱讀 37,882評論 0贊 268
萬榮殺人案實錄
序言：老撾萬榮一對情侶失蹤，失蹤者是張志新（化名）和其女友劉穎浑厚，沒想到半個月后股耽，有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體，經(jīng)...
沈念sama閱讀 44,330評論 1贊 303
?護林員之死
正文獨居荒郊野嶺守林人離奇死亡钳幅，尸身上長有42處帶血的膿包…… 初始之章·張勛以下內(nèi)容為張勛視角年9月15日...
茶點故事閱讀 36,651評論 2贊 327
?白月光啟示錄
正文我和宋清朗相戀三年物蝙，在試婚紗的時候發(fā)現(xiàn)自己被綠了。大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片敢艰。...
茶點故事閱讀 38,789評論 1贊 341
活死人
序言：一個原本活蹦亂跳的男人離奇死亡诬乞，死狀恐怖，靈堂內(nèi)的尸體忽然破棺而出，到底是詐尸還是另有隱情震嫉，我是刑警寧澤森瘪，帶...
沈念sama閱讀 34,477評論 4贊 333
?日本核電站爆炸內(nèi)幕
正文年R本政府宣布，位于F島的核電站票堵，受9級特大地震影響柜砾，放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜换衬，卻給世界環(huán)境...
茶點故事閱讀 40,135評論 3贊 317
男人毒藥：我在死后第九天來索命
文/蒙蒙一、第九天我趴在偏房一處隱蔽的房頂上張望证芭。院中可真熱鬧瞳浦，春花似錦、人聲如沸废士。這莊子的主人今日做“春日...
開封第一講書人閱讀 30,864評論 0贊 21
一樁弒父案，背后竟有這般陰謀
文/蒼蘭香墨我抬頭看了看天上的太陽官硝。三九已至矗蕊，卻和暖如春，著一層夾襖步出監(jiān)牢的瞬間氢架，已是汗流浹背傻咖。一陣腳步聲響...
開封第一講書人閱讀 32,099評論 1贊 267
情欲美人皮
我被黑心中介騙來泰國打工，沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留岖研，地道東北人卿操。一個月前我還...
沈念sama閱讀 46,598評論 2贊 362
代替公主和親
正文我出身青樓，卻偏偏與公主長得像孙援，于是被迫代替她去往敵國和親害淤。傳聞我的和親對象是個殘疾皇子，可洞房花燭夜當晚...
茶點故事閱讀 43,697評論 2贊 351

票交所區(qū)塊鏈POC api

說明

api

1.交易所

1.1創(chuàng)建交易所

1.2查詢交易所

2.用戶

2.1用戶上鏈

2.2查詢用戶

3.票據(jù)

3.1 票據(jù)上鏈

3.2 票據(jù)查詢

4.交易

4.1交易創(chuàng)建

4.2買方確認

4.3賣方確認

4.4買方取消

4.5賣方取消

4.5交易查詢

5.資產(chǎn)

5.1資產(chǎn)打包上鏈

5.2資產(chǎn)狀態(tài)更新

5.3資產(chǎn)查詢

推薦閱讀更多精彩內(nèi)容