极速查询共享系统接口对接文档（外）（学习模板）

第6页共21页仅个人知识研究和学习，不能作为参考不动产查询共享系统接口对接文档(知识研究和学习)1.1、系统概述建立健全解决执行难问题长效机制，确保生效法律文书得到有效执行，切实维护公民、法人和其他组织的合法权益，维护法律权威和尊严，推进社会诚信体系建设，不动产管理部门应当协助其他委办处理以下内容：查询有关不动产登记情况，并将有关情况及时反馈。从各部门系统的实际需求出发，首先需明确本部门与不动产管理部门涉及不动产信息查询业务数据交互的各项数据，确定后再制定数据交互的接口规范。1.2、数据交互模式本设计的主要目的是为各协执单位的信息反馈提供批量处理功能，提高处理效率；根据实际需求，调用方系统与不动产管理部门的数据交互需提供自动处理模式。1.2.1、自动处理模式(1)、开发环境说明采取自动处理模式的单位，数据交互通过调用接口来实现，对于数据交换过程中，请求数据命令、反馈结果等信息采用了JSON的方式进行传输；涉及的具体内容请参见本文第3条“接口开发说明”。(2)、各方需完成的开发工作各部门及不动产管理部门涉及的开发工作定义如下：调用方提供不动产查询请求，并将请求传入不动产管理部门接口。不动产管理部门端根据查询请求内容，形成反馈数据并返回给调用方系统；具体参见本文第2节“接口开发说明”。1.3、数据交互流程1.3.1、自动处理模式由调用方主动发起调用（采用定时或轮循机制）不动产管理部门查询共享系统查询接口服务，查询共享系统系统根据调用方传入的查询请求应用解析、分析处理，形成反馈数据报文，再反馈结果。2、数据交互接口开发说明2.1、数据要求说明2.1.1、查询请求内容各部门提起查询请求后，查询请求的具体内容参见下表：序号内容代码类型位置说明1令牌MIYAOvarchar(512)headers请求令牌，用于识别权限等。2应用IDappidlongbody本系统为查询应用分配的ID3数据dataVarchar(1)body具体的查询数据，具体可见样例4签名sXXXvarchar(30)body请求数据签名，确保数据传输过程中不被篡改。2.1.2、不动产反馈数据内容不动产管理部门需反馈给查询用户的不动产信息(result)如下：序号内容代码类型说明1不动产单元号BDCDYHVarchar(30)主键2坐落ZLVarchar(200)坐落3权利类型QLLXVarchar(2)表A.84用途YTVarchar(3)表A.175登记机构DJJGVarchar(200)登记机构6登记时间DJSJData登记时间7不动产权证号BDCQZHVarchar(500)不动产权证号8共有情况GYQKVarchar(300)共有情况9权利性质QLXZVarchar(2)表A.910实测套内面积TNMJNUMBER(15)实测套内建筑面积11实测建筑面积JZMJNUMBER(15)实测分摊建筑面积12使用期限SYQXNUMBER(15)使用期限13权利人名称QLRMCVarchar(200)权利人名称14抵押状态DYZTVarchar(2)0：无抵押，1：有抵押15查封状态CFZTVarchar(2)0：无查封，1：有查封2.2、数据接口说明2.2.1、自动处理模式调用方系统与不动产管理部门之间的通信，通过直接调用不动产查询共享系统接口，具体接口定义如下：（1）、查询请求功能说明描述：调用接口传入的查询请求内容。原型http://XXXX.XXXX.XXXX.XXXX/XXXapi/eXXXe/queryBDCInfo请求方式POST输入参数data:查询请求报文，sXXX是对data参数的签名,appid:为分配的查询应用id输入参数说明data：JSON格式的报文需要进行base64编码。SXXX是签名。appid需要申请获得。报文详情Base64编码前data串样例：{

"queryInfo":[

{

"name":"张三",

"qzh":"靖XXX（2008）9847号"

},

{

"qzh":"XXX"

},

{

"name":"李四"

}

],

"timestamp":XXXXXXXXX

}name为被查询人姓名，qzh为被查询不动产的权证号,timestamp为当前时间戳。可以批量查询，一次不超过20个。姓名和不动产权证号，必须填其中一个。详情可以参考代码样例签名说明sXXX需要data编码以后，拼接秘钥后进行MD5摘要算法计算后得出。可参考SXXXUtils中的main方法中的拼接，编码，签名方式返回说明{"code":200,"data":"xxx","message":"xxx"}code为状态码，data为返回数据，message:为提示信息，查询获得信息在result中,result中具体字段含义，可以参考2.1.2项说明返回示例{

"code":200,

"data":[

{

"name":"张三",

"qzh":"靖XXX（2008）9847号",

"result":[]

},

{

"qzh":"靖XXX（2008）32560号",

"result":[

{

"ID":"451025a084d306-3a0e-43f7-82c4-ce14e619649d-451025a4f101e5-30d8-4740-a2a9-8b9945e85a94-4510255a874635-eb81-42f5-8ab0-802d3e278959",

"DJJG":"",

"DJSJ":"2018-02-0518:39:14",

"BDCQZH":"靖XXX（2008）32560号",

"QLRMC":"XXX",

"GYQK":"",

"ZL":"靖西县新靖镇城东路金山嘉园6栋6号车库",

"BDCDYH":"451025123616GB00103F00060009",

"QLLX":"4",

"QLXZ":"",

"YT":"80",

"JZMJ":7.09,

"TNMJ":6.843,

"SYQX":""

},

{

"ID":"451025a084d306-3a0e-43f7-82c4-ce14e619649d-4510251b345d0d-9105-472e-a8c7-bcd13449496c-4510255a874635-eb81-42f5-8ab0-802d3e278959",

"DJJG":"",

"DJSJ":"2018-02-0518:39:14",

"BDCQZH":"靖XXX（3244）32560号",

"QLRMC":"XXX",

"GYQK":"",

"ZL":"靖西县新靖镇城东路金山嘉园2栋54号车库",

"BDCDYH":"451025325016GB00103F00060009",

"QLLX":"4",

"QLXZ":"",

"YT":"80",

"JZMJ":7.09,

"TNMJ":6.843,

"SYQX":""

}

]

},

{

"name":"李四",

"result":[

{

"ID":"451321-ZH-873CE629-06C5-4847-890A-EDF1CE1D3F46-451321-ZH-842F7DA8-26C0-4F89-B14B-49126719AF55-451321-ZH-91C75A3B-4A39-4FC6-B700-0182C56C5196",

"DJJG":"",

"DJSJ":"",

"BDCQZH":"",

"QLRMC":"李四",

"GYQK":"",

"ZL":"测试坐落101",

"BDCDYH":"451321100000ZW00000F00000418",

"QLLX":"4",

"QLXZ":"",

"YT":"",

"JZMJ":152.33,

"TNMJ":145.23,

"SYQX":""

}

]

}

],

"message":"操作成功"

}2.3、代码规范说明表A.1响应编码(返回报文中code字段）响应代码响应描述200请求成功501请求时间戳超时701MIYAO过期702MIYAO失效703MIYAO验证失败704MIYAO未找到801签名验证失败500服务器异常，请联系技术人员表A.7面积单位字典表代码面积单位1方米2亩3公顷表A.8权利类型字典表代码权利类型1集体土地所有权2国家土地所有权3国有建设用地使用权4国有建设用地使用权/房屋（构筑物）所有权5宅基地使用权6宅基地使用权/房屋（构筑物）所有权7集体建设用地使用权8集体建设用地使用权/房屋（构筑物）所有权9土地承包经营权10土地承包经营权/森林、林木所有权11林地使用权12林地使用权/森林、林木使用权13草原使用权14水域滩涂养殖权15海域使用权16海域使用权/构（建）筑物所有权17无居民海岛使用权18无居民海岛使用权/构（建）筑物所有权19地役权20取水权21探矿权22采矿权99其它权利表A.9权利性质字典表代码权利性质100国有土地101划拨102出让103作价出资（入股）104国有土地租赁105授权经营106家庭承包107其它方式承包200集体土地201家庭承包202其它方式承包203批准拨用204入股205联营表A.12海域使用类型A字典表代码用海类型1渔业用海2工业用海3交通运输用海4旅游娱乐用海5海底工程用海6排污倾倒用海7造地工程用海8特殊用海9其它用海表A.13海域使用类型B字典表代码用海类型11渔业基础设施用海12围海养殖用海13开放式养殖用海14人工鱼礁用海21盐业用海22固体矿产开采用海23油气开采用海24船舶工业用海25电力工业用海26海水综合利用用海27其它工业用海31口用海32航道用海33锚地用海34路桥用海41旅游基础设施用海42浴场用海43游乐场用海51电缆管道用海52海底隧道用海53海底场馆用海61污水达标排放用海62倾倒区用海71城镇建设填海造地用海72农业填海造地用海73废弃物处置填海造地用海81研教学用海82事用海代码用海类型83海洋保护区用海84海岸防护工程用海表A.16户型结构字典表代码户型结构1层2错层3复式楼4跃层99其它表A.17房屋用途字典表代码房屋用途10住宅11成套住宅111别墅112高档公寓12非成套住宅13集体宿舍20工业、交通、仓储21工业22公共设施23铁路24民航25航运26公共运输27仓储30商业、金融、信息31商业服务32经营33旅游34金融保险35电讯信息40教育、医疗、卫生、研41教育42医疗卫生43研50文化、娱乐、体育51文化52新闻53娱乐54园林绿化55体育60办公70事80其它81涉外82宗教83监狱84物管用房表A.18房屋类型字典表代码房屋类型1住宅2商业用房3办公用房4工业用房5仓储用房6车库99其它表A.19房屋性质字典表代码房屋性质0市场化商品房1动迁房2配套商品房3公共租赁住房4廉租住房5限价普通商品住房6经济适用住房7定销商品房8集资建房9福利房99其它表A.27抵押不动产类型字典表代码抵押不动产类型1土地2土地和房屋3林地和林木4土地和在建建筑物5海域6海域和构筑物7其它表A.28抵押方式字典表代码抵押方式1

一般抵押

2

最高额抵押

表A.29预告登记种类字典表代码预告登记种类1预售商品房买卖预告登记2其它不动产买卖预告登记3预售商品房抵押权预告登记4其它不动产抵押权预告登记表A.30证件种类字典表代码证件种类1身份证2澳台身份证3护照4户口簿5官证（士兵证）6组织机构代码7营业执照99其它表A.32查封类型字典表代码查封类型1查封2轮候查封3预查封4轮候预查封表A.34共有方式字典表代码共有方式0单独所有1共同共有2按份共有3其它共有表A.36权利人类型字典表代码权利人类型1个人2企业3事业单位4国家机关99其它表A.46房屋结构字典表代码房屋结构1钢结构2钢和钢筋混凝土结构3钢筋混凝土结构4混合结构5砖木结构6其它结构表A.53无居民海岛用途字典表代码无居民海岛用途1旅游娱乐用岛2交通运输用岛3工业用岛4仓储用岛5渔业用岛6农林牧业用岛7可再生能源用岛8城乡建设用岛9公共服务用岛表A.54土地利用现状分类字典表代码名称分类01耕地011水田012水浇地013旱地02园地021果园022茶园023其他园地03林地031有林地032灌木林地033其他林地04草地041天然牧草地042人工牧草地043其他草地05商服用地051批发零售用地052住宿餐饮用地053商务金融用地054其他商服用地06工矿仓储用地061工业用地062采矿用地063仓储用地07住宅用地071城镇住宅用地072农村宅基地08公共管理与公共服务用地081机关团体用地082新闻出版用地083教用地084医卫慈善用地085文体娱乐用地086公共设施用地087公园与绿地088风景名胜设施用地09特殊用地091事设施用地092使领馆用地093监教场所用地094宗教用地095殡葬用地10交通运输用地101铁路用地102公路用地103街巷用地104农村道路105机场用地106口码头用地107管道运输用地11水域及水利设施用地111河流水面112湖泊水面113水库水面114坑塘水面115沿海滩涂116内陆滩涂117沟渠118水工建筑用地119冰川及永久积雪12其他土地121空闲地122设施农用地123田坎124盐碱地125沼泽地126沙地127裸地3、代码示例 3.1、接口调用示例代码3.1.1、data参数拼接与编码与签名Mapmap=newHashMap();

map.put("timestamp",System.currentTimeMillis());

List<Map<String,String>>list=newArrayList<>();

Mapa=newHashMap();

a.put("name","张三");

a.put("qzh","靖XXX（2008）5345");

list.add(a);

Mapb=newHashMap();

b.put("qzh","靖XXX（2008）435");

list.add(b);

Mapc=newHashMap();

c.put("name","李四");

list.add(c);

map.put("queryInfo",list);

ObjectMapperobjectMapper=newObjectMapper();

System.out.println(objectMapper.writeValueAsString(map));

Stringparam=Base64.getEnc