SZSD 0024-2024政務(wù)區(qū)塊鏈服務(wù)平臺(tái)接口規(guī)范

SZSDGovernmentblockchainserviceplatforminterfaceI 2 2 本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定鄭旭、李建華、劉貞、陳園園、李進(jìn)、夏晗、何耀1政務(wù)區(qū)塊鏈服務(wù)平臺(tái)接口規(guī)范本文件適用于指導(dǎo)各級(jí)政務(wù)服務(wù)部門基于山東省政務(wù)區(qū)塊鏈服務(wù)平臺(tái)開展業(yè)務(wù)應(yīng)3.13.23.34縮略語(yǔ)URL：統(tǒng)一資源定位符（UniformRUUID：通用唯一標(biāo)識(shí)（Universallya)接口描述：應(yīng)描述出接口的概要信息；2?改變數(shù)據(jù)的接口用POST，如:新增接口，編輯接口，刪除接口等。d)請(qǐng)求參數(shù)：應(yīng)給出參數(shù)名、參數(shù)說(shuō)明、類型、是否必填等輸入信息；e)返回參數(shù)：若有返回參數(shù)，應(yīng)給出參數(shù)名、參數(shù)說(shuō)明、類型等輸出信息，參見附f)接口返回示例：應(yīng)提供接口返回實(shí)例，參見123456789NFT合約部署NFT建立3POST:http://應(yīng)用地址/login/passwusername是password是是uuid是tokentoken生成時(shí)間，“YYYY年MM月DD日MM分SS秒”顯示格式為“yyyy-mhh:mm:ss”，如“2023年10月10日12時(shí)12分12秒”格式為“2023-10-1012:12:12”token過期時(shí)間，單位(秒)7.2手機(jī)登錄POST:http://應(yīng)用地址/login/pho4phoneNumber是手機(jī)短信驗(yàn)證碼是是uuid是uuid是tokentoken生成時(shí)間，“yyyy年MM月dd日HH時(shí)HH:mm:ss”，如“2023年10月10日12時(shí)12分12秒”格式為“2023-10-1012:12:12”token過期時(shí)間，單位(秒)7.3創(chuàng)建數(shù)字身份POST:http://應(yīng)用地址/login/pho是5privateKey7,4業(yè)務(wù)子鏈交易信息報(bào)送是是是是nonce是txList是txList包含的元素說(shuō)明是是number是heightnumber是是是址是number是6FISCO鏈填寫grpId是是是是是是nonce是blockList是blockList包含的元素說(shuō)明heightnumber是nodeAddress是nodeName是txNum是preBlockHash是blockHash是7是是grpId字段(FISCOBCOS鏈)等，應(yīng)全局唯是7.6業(yè)務(wù)子鏈合約信息報(bào)送POST:http://應(yīng)用地址/api/v是是是是nonce是是是是number是是8number是是payload是是version是是FISCO鏈填寫grpId等，需要全局是7.7業(yè)務(wù)子鏈基礎(chǔ)信息報(bào)送POST:http://應(yīng)用地址/api/v1/是9是是是nonce是basicInfo是basicInfo包含的元素說(shuō)明是是是number是backBoneNodeBid是是trafficWarningnumber是number是是是number是number是number是number是是version是是number是是是，（是是是是province是是是7.8業(yè)務(wù)子鏈狀態(tài)信息報(bào)送POST:http://應(yīng)用地址/ap是是是是nonce是是blockHeightnumber是txNumbernumber是number是validationNodeCountnumber是number是number是normalContractCountnumber是number是number是7.9業(yè)務(wù)子鏈節(jié)點(diǎn)信息報(bào)送POST:http://應(yīng)用地址/api/v是是是是nonce是nodeList是nodeList包含的元素說(shuō)明nodeAddress是是number是bindNodeBid是是是是typenumber是p2pAddress是number是hostIp是number是是是是是是是是8.2創(chuàng)建聯(lián)盟是是是是nodeList是nodeList包含的元素說(shuō)明nodeType是是是8.3安裝合約是是是是binUrlbin文件儲(chǔ)存地址是是privacyType是privacyNode是是upgradeType是upgradeVersion是8.4添加節(jié)點(diǎn)是nodeType是是是8.5邀請(qǐng)成員是是9.1.1接口描述9.1.3請(qǐng)求參數(shù)是否bizId否bizType否否9.1.4返回參數(shù)9.2.1接口描述9.2.3請(qǐng)求參數(shù)是publicKey是payload是9.2.4返回參數(shù)是是是publicKey是payload是是是驗(yàn)證結(jié)果：“吻合”|“不吻合”是10.1服務(wù)注冊(cè)是是是是providerName是providerLogo是phone是是是是是nodeData是是是10.2服務(wù)申請(qǐng)是是purpose是是是是是是是nodeData是是是userId是privateKey是是type是11.2驗(yàn)證簽名publicKey是是是type是是是是是NFT規(guī)范ID是12.3NFT鑄造nftFilePath是是是是是是是是Number是否是c）POST：經(jīng)過服務(wù)器處理客戶端傳來(lái)的數(shù)據(jù),適該請(qǐng)求有多種可能的響應(yīng)，用戶代理或者用該狀態(tài)碼表示所請(qǐng)求的URI資源路徑已經(jīng)改變,因此客戶端在以后訪問時(shí)還得繼續(xù)使用該URI。新的URL會(huì)NotFound服務(wù)器不支持該請(qǐng)求中使用的方法，比如POST和服務(wù)器作為網(wǎng)關(guān)且不能從上游服務(wù)器及時(shí)的得到響應(yīng)返回給客戶端