服务商申请数据服务前需先注册应用,审核通过后会获取系统分配的appID和appKey,这两个参数将作为鉴权依据在数据服务交互过程使用。
服务商使用账号登录服务体系,进入管理中心订阅自己所需的数据服务,可以根据过滤选项过滤不需要的数据。数据服务订阅申请通过管理员审核后会返回订阅服务编码,服务商需妥善保存该编码。
提供给第三方应用机构信息报文订阅与发布
字段名 | 类型 | 最大长度 | 是否必填 | 正则表达式 | 说明 |
---|---|---|---|---|---|
operatorType | int | 1 | 是 | ^[1,2,3]$ | 修改状态码,1-新增,2-修改,3-删除 |
id | String | 32 | 是 | 主键id | |
orgaName | String | 40 | 是 | 机构名称 | |
orgaCode | String | 32 | 否 | 机构CODE | |
orgaDomain | String | 2 | 否 | 是否法人机构 | |
regionId | String | 32 | 否 | 区域ID | |
provinceCode | String | 20 | 否 | 省份 | |
cityCode | String | 20 | 否 | 市 | |
areaCode | String | 20 | 否 | 所属城区/县,如:湖北省-武汉市-洪山区 | |
orgaType | String | 2 | 否 | 机构类型 | |
parentId | String | 64 | 否 | 父机构CODE | |
orgaLevel | int | 11 | 否 | 机构级别 | |
sortNum | int | 11 | 否 | 年级级号|班级班号 | |
orgaAddress | String | 200 | 否 | 机构地址 |
(2)用户信息报文
提供给第三方应用用户信息报文订阅与发布
字段名 | 类型 | 最大长度 | 是否必填 | 正则表达式 | 说明 |
---|---|---|---|---|---|
operatorType | int | 1 | 是 | ^[1,2,3]$ | 修改状态码,1-新增,2-修改,3-删除 |
id | String | 32 | 是 | 主键id | |
name | String | 50 | 是 | 姓名 | |
account | String | 32 | 是 | 账号 | |
defaultIdentity | String | 1 | 否 | 默认角色类型 | |
password | String | 200 | 否 | 账号密码 | |
phone | String | 20 | 否 | 电话号码 | |
String | 50 | 否 | |||
String | 50 | 否 | |||
qqNum | String | 50 | 否 | ||
schoolRollNo | String | 50 | 否 | 学籍号 | |
idCardNo | String | 32 | 否 | 证件号码 | |
birthday | String | 30 | 否 | ^[0-9]{4}[-][0-9]{2}[-][0-9]{2}$ | 生日(YYYY-MM-dd) |
gender | String | 1 | 否 | 性别 | |
provinceCode | String | 20 | 否 | 省份CODE | |
cityCode | String | 20 | 否 | 市code | |
areaCode | String | 20 | 否 | 县/区code | |
address | String | 50 | 否 | 地址 | |
activeState | String | 2 | 否 | 活动状态 | |
defaultPwd | String | 200 | 否 | 默认密码 |
2.2申请订阅报文服务顺序须知
服务商在申请订阅服务时,对于基础数据而言,建议申请顺序:机构信息消费报文服务->用户信息消费报文服务。
服务类型中的级别下拉框是为了区分敏感字段数据而设置的,比如用户报文会包含用户地址,电话,email等敏感信息,我们将这样的报文分级后,1级报文就不会显示这样敏感字段,级别越高显示的字段越多,可以通过“查看报文格式”了解具体的级别报文格式。
第三方服务商还可以配置报文数据过滤来订阅自己想要的数据,比如可以选择区域“湖北”只获取指定省份的报文数据,也支持多选区域。
第三方也可以申请发布数据服务,为数据交换平台推送数据。换句话说也就是第三方做推送方,数据交换平台做数据同步方。这里就会涉及到同一业务字段两系统数据规范不一致的情况,比如第三方定义的性别:0:女 1:男,而数据交换平台定义的性别:1:男 2:女。
为了解决这种冲突,就需要在发布申请页面配置对应的字典映射,数据交换平台在同步的过程中会自动转换并入库保存数据。
目前提供了4种数据服务,分别对应着订阅与发布;订阅/发布报文服务被审核通过后,都可以通过提供的SDK对报文进行消费/推送。