数据交换流程

1、数据交换流程

2、数据服务申请

服务商申请数据服务前需先注册应用,审核通过后会获取系统分配的appID和appKey,这两个参数将作为鉴权依据在数据服务交互过程使用。

服务商使用账号登录服务体系,进入管理中心订阅自己所需的数据服务,可以根据过滤选项过滤不需要的数据。数据服务订阅申请通过管理员审核后会返回订阅服务编码,服务商需妥善保存该编码。

2.1报文格式说明

(1)机构信息报文
①报文描述

提供给第三方应用机构信息报文订阅与发布

②报文定义
字段名类型最大长度是否必填正则表达式说明
operatorTypeint1^[1,2,3]$修改状态码,1-新增,2-修改,3-删除
idString32  主键id
orgaNameString40  机构名称
orgaCodeString32   机构CODE
orgaDomainString2   是否法人机构
regionIdString32  区域ID
provinceCodeString20   省份
cityCodeString20  
areaCodeString20  所属城区/县,如:湖北省-武汉市-洪山区
orgaTypeString2   机构类型
parentIdString64   父机构CODE
orgaLevelint11  机构级别
sortNumint11   年级级号|班级班号
orgaAddressString200   机构地址

 (2)用户信息报文

①报文描述

提供给第三方应用用户信息报文订阅与发布

②报文定义
字段名类型最大长度是否必填正则表达式说明
operatorTypeint1^[1,2,3]$修改状态码,1-新增,2-修改,3-删除
idString32  主键id
nameString50  姓名
accountString32   账号
defaultIdentityString1   默认角色类型
passwordString200  账号密码
phoneString20   电话号码
emailString50  email
wechatString50  wechat
qqNumString50   qq
schoolRollNoString50   学籍号
idCardNoString32  证件号码
birthdayString30^[0-9]{4}[-][0-9]{2}[-][0-9]{2}$生日(YYYY-MM-dd)
genderString1   性别
provinceCodeString20   省份CODE
cityCodeString20   市code
areaCodeString20   县/区code
addressString50   地址
activeStateString2   活动状态
defaultPwdString200   默认密码

 

2.2申请订阅报文服务顺序须知

服务商在申请订阅服务时,对于基础数据而言,建议申请顺序:机构信息消费报文服务->用户信息消费报文服务。


2.3 申请订阅服务说明

服务类型中的级别下拉框是为了区分敏感字段数据而设置的,比如用户报文会包含用户地址,电话,email等敏感信息,我们将这样的报文分级后,1级报文就不会显示这样敏感字段,级别越高显示的字段越多,可以通过“查看报文格式”了解具体的级别报文格式。

第三方服务商还可以配置报文数据过滤来订阅自己想要的数据,比如可以选择区域“湖北”只获取指定省份的报文数据,也支持多选区域。

 

2.4申请发布服务说明

第三方也可以申请发布数据服务,为数据交换平台推送数据。换句话说也就是第三方做推送方,数据交换平台做数据同步方。这里就会涉及到同一业务字段两系统数据规范不一致的情况,比如第三方定义的性别:0:女 1:男,而数据交换平台定义的性别:1:男 2:女。

为了解决这种冲突,就需要在发布申请页面配置对应的字典映射,数据交换平台在同步的过程中会自动转换并入库保存数据。 

目前提供了4种数据服务,分别对应着订阅与发布;订阅/发布报文服务被审核通过后,都可以通过提供的SDK对报文进行消费/推送。