不動(dòng)產(chǎn)登記電子證照接口調(diào)用技術(shù)導(dǎo)則

（資料性）

不動(dòng)產(chǎn)登記電子證照接口信息證照制證接口方式該接口采用HTTPS+JSON的接口方式。請求方法該接口請求方法為POST請求。請求參數(shù)電子證照制證接口請求參數(shù)見表B.1。電子證照制證接口請求參數(shù)參數(shù)名稱類型描述信息channelIdString機(jī)構(gòu)ID，各市縣不動(dòng)產(chǎn)登記機(jī)構(gòu)的唯一標(biāo)識(shí)，由省級不動(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":"所屬者/法人的身份證號碼"，"faceImg":"證照頭像，base64格式"，"info":{"base":{"qxdm":"行政區(qū)劃代碼"，"ywh":"辦件業(yè)務(wù)號"，"zzhmz":"證照號碼（字）"，"zzhmnf":"證照號碼（年份）"，"zzhmdqjc":"證照號碼（市縣全稱）"，"zzhmh":"證照號碼（號）"，"zzr":"制證人"，"sjlx":"數(shù)據(jù)類型"，"sxdm":"關(guān)聯(lián)事項(xiàng)代碼"，"djlxdm":"登記類型代碼"，"qllxdm":"權(quán)利類型代碼"，"qlxzdm":"權(quán)利性質(zhì)代碼"，"gyr":"共有人（多個(gè)以“^”分隔）"，"gyrzjh":"共有人證件號（多個(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)證書號"，"yzbh":"編號（省級不動(dòng)產(chǎn)登記業(yè)務(wù)主管部門生成，賦值）"，"qlrmc":"權(quán)利人名稱（多個(gè)以“^”分隔）"，"qlrzjhm":"權(quán)利人證件號碼（多個(gè)以“^”分隔）"，"qlrzjlx":"權(quán)利人證件類型（多個(gè)以“^”分隔）"，"gyqk":"共有情況"，"zl":"坐落"，"bdcdyh":"不動(dòng)產(chǎn)單元號"，"qllx":"權(quán)利類型（照面值，名稱按照國標(biāo)匹配）"，"qlxz":"權(quán)利性質(zhì)（照面值，名稱按照國標(biāo)匹配）"，"yt":"用途（照面值）"，"mj":"面積（照面值）"，"qlqtzk":"權(quán)利其他狀況（多行情況下，使用換行符‘ ’換行）"，"fj":"附記（多行情況下，使用換行符‘ ’換行）"，"ft1":"附圖（base64編碼值）"，"ft2":"附圖（base64編碼值）"，"ft3":"附圖（base64編碼值）"，"zzbfrq":"證照頒發(fā)日期"，"zzyxqqsrq":"使用期限起"，"zzyxqjzrq":"使用期限止"}}}證照更新接口方式該接口采用HTTPS+JSON的接口方式。請求方法該接口請求方法為POST請求。請求參數(shù)電子證照更新接口請求參數(shù)見表B.3。電子證照更新接口請求參數(shù)參數(shù)名稱類型描述信息channelIdString機(jī)構(gòu)ID，各市縣不動(dòng)產(chǎn)登記機(jī)構(gòu)的唯一標(biāo)識(shí)，由省級不動(dòng)產(chǎn)登記業(yè)務(wù)主管部門電子證照系統(tǒng)生成dataString加密數(shù)據(jù)包返回結(jié)果電子證照更新接口返回結(jié)果見表B.4。電子證照更新接口返回結(jié)果參數(shù)名稱類型描述信息messageString返回結(jié)果說明errorint錯(cuò)誤碼；0.成功；-1.失敗接口示例//請求參數(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的接口方式。請求方法該接口請求方法為POST請求。請求參數(shù)電子證照簽發(fā)接口請求參數(shù)見表B.5。電子證照簽發(fā)接口請求參數(shù)參數(shù)名稱類型描述信息channelIdString機(jī)構(gòu)ID，各市縣不動(dòng)產(chǎn)登記機(jī)構(gòu)的唯一標(biāo)識(shí)，由省級不動(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文件接口示例//請求參數(shù){"orgId":"jnsbdcdjzx"，"timestamp":"1569748316"，"qfr":"張三"，"certIdentifier":"005.2.11100000000013338W002.1132048201413*****"，"yzh":"印章編號"}//返回結(jié)果{"message":"成功"，"error":0，"data":{"certidentifier":"005.2.11100000000013338W002.11320482014***"，"data":"已經(jīng)簽章的base64編碼OFD文件"}}證照注銷接口方式該接口采用HTTPS+JSON的接口方式。請求方法該接口請求方法為POST請求。請求參數(shù)電子證照注銷接口請求參數(shù)見表B.7。電子證照注銷接口請求參數(shù)參數(shù)名稱類型描述信息channelIdString機(jī)構(gòu)ID，各市縣不動(dòng)產(chǎn)登記機(jī)構(gòu)的唯一標(biāo)識(shí)，由省級不動(dòng)產(chǎn)登記業(yè)務(wù)主管部門電子證照系統(tǒng)生成dataString加密數(shù)據(jù)包返回結(jié)果電子證照注銷接口返回結(jié)果見表B.8。電子證照注銷接口返回結(jié)果參數(shù)名稱類型描述信息messageString返回結(jié)果說明errorint錯(cuò)誤碼；0.成功；-1.失敗接口示例//請求參數(shù){"orgId":"jnsbdcdjzx"，"timestamp":"1569748316"，"zzr":"張三"，"certIdentifier":"005.2.11100000000013338W002.1132048201413****"}//返回結(jié)果{"message":"成功"，"error":0}證照下載證照標(biāo)識(shí)獲取下載地址接口方式該接口采用HTTPS+JSON的接口方式。請求方法該接口請求方法為POST請求。請求參數(shù)電子證照標(biāo)識(shí)獲取下載地址接口請求參數(shù)見表B.9。電子證照標(biāo)識(shí)獲取下載地址接口請求參數(shù)參數(shù)名稱類型必填描述信息head.accessIdString是訪問標(biāo)識(shí)，由省級不動(dòng)產(chǎn)登記業(yè)務(wù)主管部門電子證照系統(tǒng)生成并告知各接口調(diào)用單位head.accessTokenString是應(yīng)用認(rèn)證信息，由省級不動(dòng)產(chǎn)登記業(yè)務(wù)主管部門電子證照系統(tǒng)生成并告知各接口調(diào)用單位授權(quán)碼（機(jī)構(gòu)ID）head.accessUserString是請求查詢?nèi)藛Thead.accessModeString是查詢方式，包括移動(dòng)APP、微信號、PC網(wǎng)頁、業(yè)務(wù)應(yīng)用等data.useCauseString是申請事由，不超過200字data.expiryTimeString是電子證照加注件有效期截止時(shí)間YYYY-MM-DDdata.useScenarioString是申請使用場景，包括移動(dòng)APP、微信號、PC網(wǎng)頁、業(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的要求接口示例//請求參數(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的接口方式。請求方法該接口請求方法為POST請求。請求參數(shù)電子證照標(biāo)識(shí)獲取下載OFD證照文件接口請求參數(shù)見表B.11。電子證照標(biāo)識(shí)獲取下載OFD證照文件接口請求參數(shù)參數(shù)名稱類型必填描述信息head.accessIdString是訪問標(biāo)識(shí)，由省級不動(dòng)產(chǎn)登記業(yè)務(wù)主管部門電子證照系統(tǒng)生成并告知各接口調(diào)用單位head.accessTokenString是應(yīng)用認(rèn)證信息，由省級不動(dòng)產(chǎn)登記業(yè)務(wù)主管部門電子證照系統(tǒng)生成并告知各接口調(diào)用單位授權(quán)碼機(jī)構(gòu)IDhead.accessUserString是請求查詢?nèi)藛Thead.accessModeString是查詢方式，包括移動(dòng)APP、微信號、PC網(wǎng)頁、業(yè)務(wù)應(yīng)用等data.useCauseString是申請事由，不超過200字data.expiryTimeString是電子證照加注件有效期截止時(shí)間YYYY-MM-DDdata.useScenarioString是申請使用場景，包括移動(dòng)APP、微信號、PC網(wǎng)頁、業(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格式）接口示例//請求參數(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的接口方式。請求方法該接口請求方法為POST請求。請求參數(shù)電子證照標(biāo)識(shí)獲取證照信息接口請求參數(shù)見表B.13。電子證照標(biāo)識(shí)獲取下證照信息接口請求參數(shù)參數(shù)名稱類型必填描述信息head.accessIdString是訪問標(biāo)識(shí)，由省級不動(dòng)產(chǎn)登記業(yè)務(wù)主管部門電子證照系統(tǒng)生成并告知各接口調(diào)用單位head.accessTokenString是應(yīng)用認(rèn)證信息，由省級不動(dòng)產(chǎn)登記業(yè)務(wù)主管部門電子證照系統(tǒng)生成并告知各接口調(diào)用單位head.accessUserString是請求查詢?nèi)藛Thead.accessModeString是查詢方式，包括移動(dòng)APP、微信號、PC網(wǎng)頁、業(yè)務(wù)應(yīng)用等data.certIdentifierString是電子證照標(biāo)識(shí)，其值應(yīng)符合GB∕T36904—2018的要求data.useCauseString是申請事由，不超過200字data.useScenarioString是申請使用場景，包括移動(dòng)APP、微信號、PC網(wǎng)頁、業(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加密后的電子證照照面信息接口示例//請求參數(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的接口方式。請求方法該接口請求方法為POST請求。請求參數(shù)電子證照文件有效性驗(yàn)證接口請求參數(shù)見表B.15。電子證照文件有效性驗(yàn)證接口請求參數(shù)參數(shù)名稱類型必填描述信息head.accessIdString是訪問標(biāo)識(shí)，由省級不動(dòng)產(chǎn)登記業(yè)務(wù)主管部門電子證照系統(tǒng)生成并告知各接口調(diào)用單位head.accessTokenString是應(yīng)用認(rèn)證信息，由省級不動(dòng)產(chǎn)登記業(yè)務(wù)主管部門電子證照系統(tǒng)生成并告知各接口調(diào)用單位表B.15電子證照文件有效性驗(yàn)證接口請求參數(shù)（續(xù)）參數(shù)名稱類型必填描述信息head.accessUserString是請求查詢?nèi)藛Thead.accessModeString是查詢方式，包括移動(dòng)APP、微信號、PC網(wǎng)頁、業(yè)務(wù)應(yīng)用等data.certTypeCodeString是證照類型代碼data.contentTypeString是編碼類型為base64data.contentString是Base64字符串，解碼后的內(nèi)容應(yīng)符合GB/T36905—2018的要求data.useCauseString是申請事由，不超過200字data.useScenarioString是申請使用場景，包括移動(dòng)APP、微信號、PC網(wǎng)頁、業(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é)果代碼對應(yīng)的文字說明，如：“0”：“驗(yàn)證通過”；“1”：“簽章校驗(yàn)失敗”；“2”：“文件校驗(yàn)失敗”；“3”：“證照未激活”；“4”：“證照暫時(shí)失效”；“5”：“證照已失效”接口示例//請求參數(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的接口方式。請求方法該接口請求方法為POST請求。請求參數(shù)電子證照持有主體代碼獲取證照信息接口請求參數(shù)見表B.17。電子證照持有主體代碼獲取證照信息接口請求參數(shù)參數(shù)名稱類型必填描述信息head.accessIdString是訪問標(biāo)識(shí)，由省級不動(dòng)產(chǎn)登記業(yè)務(wù)主管部門電子證照系統(tǒng)生成并告知各接口調(diào)用單位head.accessTokenString是應(yīng)用認(rèn)證信息，由省級不動(dòng)產(chǎn)登記業(yè)務(wù)主管部門電子證照系統(tǒng)生成并告知各接口調(diào)用單位head.accessUserString是請求查詢?nèi)藛Thead.accessModeString是查詢方式，包括移動(dòng)APP、微信號、PC網(wǎng)頁、業(yè)務(wù)應(yīng)用等data.holderCodeString是持證主體代碼，如：身份證中的身份證號碼data.holderTypeCodeString是持證主體代碼類型代碼data.certTypeCodeString是證照類型代碼data.certNoString是證照編號data.useCauseString是申請事由，不超過200字data.useScenarioString是申請使用場景，包括移動(dòng)APP、微信號、PC網(wǎng)頁、業(yè)務(wù)應(yīng)用等返回結(jié)果電子證照持有主體代碼獲取證照信息接口返回結(jié)果見表B.18。電子證照持有主體代碼獲取證照信息接口返回結(jié)果參數(shù)名稱類型描述信息head.statusint錯(cuò)誤碼；0.成功；其他.失敗head.messageString返回結(jié)果說明data.certDataString加密后的電子證照照面信息接口示例//請求參數(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":"04D4FB95943B9E0419390A37B48A6F2805F9091……"}}證照核對接口方式該接口采用HTTPS+JSON的接口方式。請求方法該接口請求方法為POST請求。請求參數(shù)電子證照核對接口請求參數(shù)見表B.19。電子證照核對接口請求參數(shù)參數(shù)名稱類型必填描述信息orgIdString是固定值：403eea4b05b54b2b89a9d30d3f3227f8timestampLong