不動(dòng)產(chǎn)登記電子證照接口調(diào)用申請(qǐng)表、接口信息

（資料性）

接口調(diào)用申請(qǐng)表接口調(diào)用申請(qǐng)表見表A.1。接口調(diào)用申請(qǐng)表部門登記系統(tǒng)基本信息部門名稱系統(tǒng)名稱系統(tǒng)簡(jiǎn)要說明系統(tǒng)訪問地址系統(tǒng)運(yùn)行網(wǎng)絡(luò)聯(lián)系人信息業(yè)務(wù)聯(lián)系人業(yè)務(wù)聯(lián)系人電話技術(shù)聯(lián)系人技術(shù)聯(lián)系人電話經(jīng)辦人（簽字）：申請(qǐng)接入單位（蓋章）：

（資料性）

不動(dòng)產(chǎn)登記電子證照接口信息證照制證接口方式該接口采用HTTPS+JSON的接口方式。請(qǐng)求方法該接口請(qǐng)求方法為POST請(qǐng)求。請(qǐng)求參數(shù)電子證照制證接口請(qǐng)求參數(shù)見表B.1。電子證照制證接口請(qǐng)求參數(shù)參數(shù)名稱類型描述信息channelIdString機(jī)構(gòu)ID，各市縣不動(dòng)產(chǎn)登記機(jī)構(gòu)的唯一標(biāo)識(shí)，由省級(jí)不動(dòng)產(chǎn)登記業(yè)務(wù)主管部門電子證照系統(tǒng)生成dataString加密數(shù)據(jù)包返回結(jié)果電子證照制證接口返回結(jié)果見表B.2。電子證照制證接口返回結(jié)果參數(shù)名稱類型描述信息messageString返回結(jié)果說明errorint錯(cuò)誤碼；0.成功；-1.失敗data.certIdentifierString電子證照唯一標(biāo)識(shí)，其值遵循GB∕T36904—2018接口示例{"channelId":"渠道ID","data":{"orgId":"證照頒發(fā)機(jī)構(gòu)的統(tǒng)一社會(huì)信用代碼","timestamp":"訪問本接口時(shí)間戳（10位數(shù)字）","certTypeCode":"證照類型代碼","ownersfzhm":"所屬者/法人的身份證號(hào)碼","faceImg":"證照頭像,base64格式","info":{"base":{"qxdm":"行政區(qū)劃代碼","ywh":"辦件業(yè)務(wù)號(hào)","zzhmz":"證照號(hào)碼（字）","zzhmnf":"證照號(hào)碼（年份）","zzhmdqjc":"證照號(hào)碼（市縣全稱）","zzhmh":"證照號(hào)碼（號(hào)）","zzr":"制證人","sjlx":"數(shù)據(jù)類型","sxdm":"關(guān)聯(lián)事項(xiàng)代碼","djlxdm":"登記類型代碼","qllxdm":"權(quán)利類型代碼","qlxzdm":"權(quán)利性質(zhì)代碼","gyr":"共有人(多個(gè)以“^”分隔)","gyrzjh":"共有人證件號(hào)(多個(gè)以“^”分隔)","gybl":"共有比例(多個(gè)以“^”分隔)","yqlrgx":"與權(quán)利人關(guān)系","fbczbs":"分別持證標(biāo)識(shí)","ytdm":"用途代碼","dymj":"不動(dòng)產(chǎn)單元面積","mjdw":"面積單位","mjdwdm":"面積單位代碼","ftmc1":"附圖名稱1","ftmc2":"附圖名稱2","ftmc3":"附圖名稱3","ftjzd":[{"jd":"界址點(diǎn)1經(jīng)度","wd":"界址點(diǎn)1緯度"},{"jd":"界址點(diǎn)2經(jīng)度","wd":"界址點(diǎn)2緯度"}]},"certno":"不動(dòng)產(chǎn)權(quán)證書號(hào)","yzbh":"編號(hào)（省級(jí)不動(dòng)產(chǎn)登記業(yè)務(wù)主管部門生成,賦值）","qlrmc":"權(quán)利人名稱(多個(gè)以“^”分隔)","qlrzjhm":"權(quán)利人證件號(hào)碼(多個(gè)以“^”分隔)","qlrzjlx":"權(quán)利人證件類型(多個(gè)以“^”分隔)","gyqk":"共有情況","zl":"坐落","bdcdyh":"不動(dòng)產(chǎn)單元號(hào)","qllx":"權(quán)利類型（照面值，名稱按照國(guó)標(biāo)匹配）","qlxz":"權(quán)利性質(zhì)（照面值，名稱按照國(guó)標(biāo)匹配）","yt":"用途（照面值）","mj":"面積（照面值）","qlqtzk":"權(quán)利其他狀況（多行情況下，使用換行符‘ ’換行）","fj":"附記（多行情況下，使用換行符‘ ’換行）","ft1":"附圖(base64編碼值)","ft2":"附圖(base64編碼值)","ft3":"附圖(base64編碼值)","zzbfrq":"證照頒發(fā)日期","zzyxqqsrq":"使用期限起","zzyxqjzrq":"使用期限止"}}}證照更新接口方式該接口采用HTTPS+JSON的接口方式。請(qǐng)求方法該接口請(qǐng)求方法為POST請(qǐng)求。請(qǐng)求參數(shù)電子證照更新接口請(qǐng)求參數(shù)見表B.3。電子證照更新接口請(qǐng)求參數(shù)參數(shù)名稱類型描述信息channelIdString機(jī)構(gòu)ID，各市縣不動(dòng)產(chǎn)登記機(jī)構(gòu)的唯一標(biāo)識(shí)，由省級(jí)不動(dòng)產(chǎn)登記業(yè)務(wù)主管部門電子證照系統(tǒng)生成dataString加密數(shù)據(jù)包返回結(jié)果電子證照更新接口返回結(jié)果見表B.4。電子證照更新接口返回結(jié)果參數(shù)名稱類型描述信息messageString返回結(jié)果說明errorint錯(cuò)誤碼；0.成功；-1.失敗接口示例//請(qǐng)求參數(shù){"orgId":"jnsbdcdjzx","timestamp":"1569748316","certIdentifier":"005.2.11100000000013338W002.1132048201413*****","info":{不動(dòng)產(chǎn)電子證書JSON數(shù)據(jù)或不動(dòng)產(chǎn)電子證明JSON數(shù)據(jù)}}//返回結(jié)果{"message":"成功","error":0}證照簽發(fā)接口方式該接口采用HTTPS+JSON的接口方式。請(qǐng)求方法該接口請(qǐng)求方法為POST請(qǐng)求。請(qǐng)求參數(shù)電子證照簽發(fā)接口請(qǐng)求參數(shù)見表B.5。電子證照簽發(fā)接口請(qǐng)求參數(shù)參數(shù)名稱類型描述信息channelIdString機(jī)構(gòu)ID，各市縣不動(dòng)產(chǎn)登記機(jī)構(gòu)的唯一標(biāo)識(shí)，由省級(jí)不動(dòng)產(chǎn)登記業(yè)務(wù)主管部門電子證照系統(tǒng)生成dataString加密數(shù)據(jù)包返回結(jié)果電子證照簽發(fā)接口返回結(jié)果見表B.6。電子證照簽發(fā)接口返回結(jié)果參數(shù)名稱類型描述信息messageString返回結(jié)果說明errorint錯(cuò)誤碼；0.成功；-1.失敗data.certIdentifierString電子證照唯一標(biāo)識(shí)，其值遵循GB∕T36904—2018data.dataString已經(jīng)簽章的base64編碼OFD文件接口示例//請(qǐng)求參數(shù){"orgId":"jnsbdcdjzx","timestamp":"1569748316","qfr":"張三","certIdentifier":"005.2.11100000000013338W002.1132048201413*****","yzh":"印章編號(hào)"}//返回結(jié)果{"message":"成功","error":0,"data":{"certidentifier":"005.2.11100000000013338W002.11320482014***","data":"已經(jīng)簽章的base64編碼OFD文件"}}證照注銷接口方式該接口采用HTTPS+JSON的接口方式。請(qǐng)求方法該接口請(qǐng)求方法為POST請(qǐng)求。請(qǐng)求參數(shù)電子證照注銷接口請(qǐng)求參數(shù)見表B.7。電子證照注銷接口請(qǐng)求參數(shù)參數(shù)名稱類型描述信息channelIdString機(jī)構(gòu)ID，各市縣不動(dòng)產(chǎn)登記機(jī)構(gòu)的唯一標(biāo)識(shí)，由省級(jí)不動(dòng)產(chǎn)登記業(yè)務(wù)主管部門電子證照系統(tǒng)生成dataString加密數(shù)據(jù)包返回結(jié)果電子證照注銷接口返回結(jié)果見表B.8。電子證照注銷接口返回結(jié)果參數(shù)名稱類型描述信息messageString返回結(jié)果說明errorint錯(cuò)誤碼；0.成功；-1.失敗接口示例//請(qǐng)求參數(shù){"orgId":"jnsbdcdjzx","timestamp":"1569748316","zzr":"張三","certIdentifier":"005.2.11100000000013338W002.1132048201413****"}//返回結(jié)果{"message":"成功","error":0}證照下載證照標(biāo)識(shí)獲取下載地址接口方式該接口采用HTTPS+JSON的接口方式。請(qǐng)求方法該接口請(qǐng)求方法為POST請(qǐng)求。請(qǐng)求參數(shù)電子證照標(biāo)識(shí)獲取下載地址接口請(qǐng)求參數(shù)見表B.9。電子證照標(biāo)識(shí)獲取下載地址接口請(qǐng)求參數(shù)參數(shù)名稱類型必填描述信息head.accessIdString是訪問標(biāo)識(shí)，由省級(jí)不動(dòng)產(chǎn)登記業(yè)務(wù)主管部門電子證照系統(tǒng)生成并告知各接口調(diào)用單位head.accessTokenString是應(yīng)用認(rèn)證信息，由省級(jí)不動(dòng)產(chǎn)登記業(yè)務(wù)主管部門電子證照系統(tǒng)生成并告知各接口調(diào)用單位授權(quán)碼（機(jī)構(gòu)ID）head.accessUserString是請(qǐng)求查詢?nèi)藛Thead.accessModeString是查詢方式，包括移動(dòng)APP、微信號(hào)、PC網(wǎng)頁(yè)、業(yè)務(wù)應(yīng)用等data.useCauseString是申請(qǐng)事由，不超過200字data.expiryTimeString是電子證照加注件有效期截止時(shí)間YYYY-MM-DDdata.useScenarioString是申請(qǐng)使用場(chǎng)景，包括移動(dòng)APP、微信號(hào)、PC網(wǎng)頁(yè)、業(yè)務(wù)應(yīng)用等返回結(jié)果電子證照標(biāo)識(shí)獲取下載地址接口返回結(jié)果見表B.10。電子證照標(biāo)識(shí)獲取下載地址接口返回結(jié)果參數(shù)名稱類型描述信息head.statusint錯(cuò)誤碼；0.成功；其他.失敗head.messageString返回結(jié)果說明data.contentTypeString編碼類型為base64data.certIdentifierString電子證照標(biāo)識(shí)，其值遵循GB∕T36904—2018data.contentString證件文件下載地址，下載后的文件是符合GB∕T36904—2018的要求接口示例//請(qǐng)求參數(shù){"head":{"accessId":"appId","accessToken":"Gl9kClWo8GVI***","accessUser":"張三","accessMode":"40"},"data":{"certIdentifier":"005.2.***","useScenario":"10","useCause":"事由***","expiryTime":"過期時(shí)間***"}}//返回結(jié)果{"head":{"status":0,"message":"接口調(diào)用成功"},"data":"04D4FB95943B9E0419390A37B48A6F2805F9091……"}證照標(biāo)識(shí)獲取下載OFD證照文件接口方式該接口采用HTTPS+JSON的接口方式。請(qǐng)求方法該接口請(qǐng)求方法為POST請(qǐng)求。請(qǐng)求參數(shù)電子證照標(biāo)識(shí)獲取下載OFD證照文件接口請(qǐng)求參數(shù)見表B.11。電子證照標(biāo)識(shí)獲取下載OFD證照文件接口請(qǐng)求參數(shù)參數(shù)名稱類型必填描述信息head.accessIdString是訪問標(biāo)識(shí)，由省級(jí)不動(dòng)產(chǎn)登記業(yè)務(wù)主管部門電子證照系統(tǒng)生成并告知各接口調(diào)用單位head.accessTokenString是應(yīng)用認(rèn)證信息，由省級(jí)不動(dòng)產(chǎn)登記業(yè)務(wù)主管部門電子證照系統(tǒng)生成并告知各接口調(diào)用單位授權(quán)碼機(jī)構(gòu)IDhead.accessUserString是請(qǐng)求查詢?nèi)藛Thead.accessModeString是查詢方式，包括移動(dòng)APP、微信號(hào)、PC網(wǎng)頁(yè)、業(yè)務(wù)應(yīng)用等data.useCauseString是申請(qǐng)事由，不超過200字data.expiryTimeString是電子證照加注件有效期截止時(shí)間YYYY-MM-DDdata.useScenarioString是申請(qǐng)使用場(chǎng)景，包括移動(dòng)APP、微信號(hào)、PC網(wǎng)頁(yè)、業(yè)務(wù)應(yīng)用等返回結(jié)果電子證照標(biāo)識(shí)獲取下載PDF證照文件接口返回結(jié)果見表B.12。電子證照標(biāo)識(shí)獲取下載OFD證照文件接口返回結(jié)果參數(shù)名稱類型描述信息head.statusint錯(cuò)誤碼；0.成功；其他.失敗ad.messageString返回結(jié)果說明dataStringbase64編碼的證照文件內(nèi)容（OFD格式）接口示例//請(qǐng)求參數(shù){"head":{"accessId":"appId","accessToken":"Gl9kClWo8GVI***","accessUser":"張三","accessMode":"40"},"data":{"certIdentifier":"005.2.***","useScenario":"10","useCause":"事由***","expiryTime":"過期時(shí)間***"}}//返回結(jié)果{"head":{"status":0,"message":"接口調(diào)用成功"},"data":"04D4FB95943B9E0419390A37B48A6F2805F9091……"}證照標(biāo)識(shí)獲取證照信息接口方式該接口采用HTTPS+JSON的接口方式。請(qǐng)求方法該接口請(qǐng)求方法為POST請(qǐng)求。請(qǐng)求參數(shù)電子證照標(biāo)識(shí)獲取證照信息接口請(qǐng)求參數(shù)見表B.13。電子證照標(biāo)識(shí)獲取下證照信息接口請(qǐng)求參數(shù)參數(shù)名稱類型必填描述信息head.accessIdString是訪問標(biāo)識(shí)，由省級(jí)不動(dòng)產(chǎn)登記業(yè)務(wù)主管部門電子證照系統(tǒng)生成并告知各接口調(diào)用單位head.accessTokenString是應(yīng)用認(rèn)證信息，由省級(jí)不動(dòng)產(chǎn)登記業(yè)務(wù)主管部門電子證照系統(tǒng)生成并告知各接口調(diào)用單位head.accessUserString是請(qǐng)求查詢?nèi)藛Thead.accessModeString是查詢方式，包括移動(dòng)APP、微信號(hào)、PC網(wǎng)頁(yè)、業(yè)務(wù)應(yīng)用等data.certIdentifierString是電子證照標(biāo)識(shí)，其值應(yīng)符合GB∕T36904—2018的要求data.useCauseString是申請(qǐng)事由，不超過200字data.useScenarioString是申請(qǐng)使用場(chǎng)景，包括移動(dòng)APP、微信號(hào)、PC網(wǎng)頁(yè)、業(yè)務(wù)應(yīng)用等返回結(jié)果電子證照標(biāo)識(shí)獲取證照信息接口返回結(jié)果見表B.14。電子證照標(biāo)識(shí)獲取下證照信息接口返回結(jié)果參數(shù)名稱類型描述信息head.statusint錯(cuò)誤碼；0.成功；其他.失敗head.messageString返回結(jié)果說明data.certDataString加密后的電子證照照面信息接口示例//請(qǐng)求參數(shù){"head":{"accessId":"appId","accessToken":"356YDO7xXyb08mlbr/Tdk7UuFrMoLtzZx0BBtg==","accessUser":"張三","accessMode":"40"},"data":{"certIdentifier":"005.2.1110000137D001.xxxx.xxx.xx.x","useScenario":"10","useCause":"事由***"}}//返回結(jié)果{"head":{"status":0,"message":"接口調(diào)用成功"},"data":{"certData":"04D4FB95943B9E0419390A37B48A6F2805F9091……"}}證照文件有效性驗(yàn)證接口方式該接口采用HTTPS+JSON的接口方式。請(qǐng)求方法該接口請(qǐng)求方法為POST請(qǐng)求。請(qǐng)求參數(shù)電子證照文件有效性驗(yàn)證接口請(qǐng)求參數(shù)見表B.15。電子證照文件有效性驗(yàn)證接口請(qǐng)求參數(shù)參數(shù)名稱類型必填描述信息head.accessIdString是訪問標(biāo)識(shí)，由省級(jí)不動(dòng)產(chǎn)登記業(yè)務(wù)主管部門電子證照系統(tǒng)生成并告知各接口調(diào)用單位head.accessTokenString是應(yīng)用認(rèn)證信息，由省級(jí)不動(dòng)產(chǎn)登記業(yè)務(wù)主管部門電子證照系統(tǒng)生成并告知各接口調(diào)用單位表B.15電子證照文件有效性驗(yàn)證接口請(qǐng)求參數(shù)（續(xù)）參數(shù)名稱類型必填描述信息head.accessUserString是請(qǐng)求查詢?nèi)藛Thead.accessModeString是查詢方式，包括移動(dòng)APP、微信號(hào)、PC網(wǎng)頁(yè)、業(yè)務(wù)應(yīng)用等data.certTypeCodeString是證照類型代碼data.contentTypeString是編碼類型為base64data.contentString是Base64字符串，解碼后的內(nèi)容應(yīng)符合GB/T36905—2018的要求data.useCauseString是申請(qǐng)事由，不超過200字data.useScenarioString是申請(qǐng)使用場(chǎng)景，包括移動(dòng)APP、微信號(hào)、PC網(wǎng)頁(yè)、業(yè)務(wù)應(yīng)用等返回結(jié)果電子證照文件有效性驗(yàn)證接口返回結(jié)果見表B.16。電子證照文件有效性驗(yàn)證接口返回結(jié)果參數(shù)名稱類型描述信息head.statusint錯(cuò)誤碼；0.成功；其他.失敗head.messageString返回結(jié)果說明data.resultString校驗(yàn)結(jié)果，返回0表示驗(yàn)證通過，其他值表示失敗data.messageString校驗(yàn)結(jié)果說明，與校驗(yàn)結(jié)果代碼對(duì)應(yīng)的文字說明，如：“0”：“驗(yàn)證通過”；“1”：“簽章校驗(yàn)失敗”；“2”：“文件校驗(yàn)失敗”；“3”：“證照未激活”；“4”：“證照暫時(shí)失效”；“5”：“證照已失效”接口示例//請(qǐng)求參數(shù){"head":{"accessId":"apple","accessToken":"356YDO7xb08mlbr/Tdk7Uuln...eU7EyJAAm8Sx0BBtg==","accessUser":"張三","accessMode":"40"},"data":{"certTypeCode":"11100000000013127D001","contentType":"base64","content":"base64內(nèi)容","useScenario":"10","useCause":"事由***"}}//返回結(jié)果{"head":{"status":0,"message":"接口調(diào)用成功"},"data":"04D4FB95943B9E0419390A37B48A6F2805F9091……"}證照持有主體代碼獲取證照信息接口方式該接口采用HTTPS+JSON的接口方式。請(qǐng)求方法該接口請(qǐng)求方法為POST請(qǐng)求。請(qǐng)求參數(shù)電子證照持有主體代碼獲取證照信息接口請(qǐng)求參數(shù)見表B.17。電子證照持有主體代碼獲取證照信息接口請(qǐng)求參數(shù)參數(shù)名稱類型必填描述信息head.accessIdString是訪問標(biāo)識(shí)，由省級(jí)不動(dòng)產(chǎn)登記業(yè)務(wù)主管部門電子證照系統(tǒng)生成并告知各接口調(diào)用單位head.accessTokenString是應(yīng)用認(rèn)證信息，由省級(jí)不動(dòng)產(chǎn)登記業(yè)務(wù)主管部門電子證照系統(tǒng)生成并告知各接口調(diào)用單位head.accessUserString是請(qǐng)求查詢?nèi)藛Thead.accessModeString是查詢方式，包括移動(dòng)APP、微信號(hào)、PC網(wǎng)頁(yè)、業(yè)務(wù)應(yīng)用等data.holderCodeString是持證主體代碼，如：身份證中的身份證號(hào)碼data.holderTypeCodeString是持證主體代碼類型代碼data.certTypeCodeString是證照類型代碼data.certNoString是證照編號(hào)data.useCauseString是申請(qǐng)事由，不超過200字data.useScenarioString是申請(qǐng)使用場(chǎng)景，包括移動(dòng)APP、微信號(hào)、PC網(wǎng)頁(yè)、業(yè)務(wù)應(yīng)用等返回結(jié)果電子證照持有主體代碼獲取證照信息接口返回結(jié)果見表B.18。電子證照持有主體代碼獲取證照信息接口返回結(jié)果參數(shù)名稱類型描述信息head.statusint錯(cuò)誤碼；0.成功；其他.失敗head.messageString返回結(jié)果說明data.certDataString加密后的電子證照照面信息接口示例//請(qǐng)求參數(shù){"head":{"accessId":"appId","accessToken":"356YDO7xXyb08mlbr/CD0cNV…4GsJAAm8Sx0BBtg==","accessUser":"張三","accessMode":"40"},"data":{"holderCode":"370452******248024","holderTypeCode":"111","certTypeCode":"11100000MB03271699001","certNo":"T201202120001","useScenario":"10","useCause":"事由****"}}//返回結(jié)果{"head":{"status":0,"message":"接口調(diào)用成功"},"data":{"certData":"04D4FB95943B9E04