《广东省食品从业人员》由会员分享,可在线阅读,更多相关《广东省食品从业人员(24页珍藏版)》请在金锄头文库上搜索。
1、广东省食品从业人员健康检查管理平台健康证管理平台Version: 1.0.0接口规范Date: 2017-11-24Page: 24 of 24广东省食品从业人员健康检查管理平台接口规范文档2017-11改版记录版本发布日期描述作者复审批准1.02017/11/24建立该文档,初稿变更记录变更编号日期变更项描述基线版本变更请求编号 目录1概述42适用范围43接口概述43.1接口概述43.2数据类型与格式53.3接口参数格式53.3.1请求参数53.3.2响应参数63.4接口访问地址84接口逻辑结构设计84.1微信预约平台接口架构84.2体检业务监控接口架构85接口详细参数和格式95.1数据签名
2、验证95.1.1数字签名生成功能接口95.2微信端接口105.2.1体检机构信息接口115.3体检系统接口145.3.1体检登记145.3.2体检结果体检明细接口175.3.3健康证打印接口205.3.4短信通知上传接口22广东省食品从业人员健康检查管理平台接口规范文档 1 概述健康证管理平台按照省局关于体检机构现场巡查和体检业务实时监控的要求制定。目的是实时获取体检机构的实时业务监控数据,保证服务业从业人员的体检信息的真实性。主要实时监控如下:健康证管理平台提供Webservice接口应用服务,供各接入系统访问调用。在调用时,需按照本文档规定格式拼装参数,传入参数调用平台端webservic
3、e接口,接收webservice接口获取返回信息。各接入系统将返回信息进行解析后供自身系统处理使用。2 适用范围本文档主要用于描述Webservice接口的定义、调用说明。文档可供接入健康证管理平台的各系统建设方、开发方阅读及使用。3 接口概述3.1 接口概述健康证管理平台作为服务端,以WebService方式为各个第三方系统等提供接口服务。接口采用SOAP协议,请求方在请求时以base64加密入参,服务器解密处理,返回base64加密回参,请求端自行解密使用。WebService接口统一入口方法为CallFun,通过method参数进行业务区分。3.2 数据类型与格式如无特殊说明,本文档中的
4、部分数据均为以下格式:l 日期: YYYY-MM-DD,即4位年,2位月份,2位日期。数据类型记为DATE,长度为10。l 时间:HH:MM:SS,即2位小时(24小时制),2为分钟,2为秒。数据类型记为TIME,长度为6.l 日期时间:YYYY-MM-DD HH:MM:SS。数据类型记为DATETIME,长度为19.l 带毫秒日期时间:YYYY-MM-DD HH:MM:SS:FFF。FFF为毫秒数。数据类型记为DATETIME,长度为17。l 金额:DDDDDDDD.DD,整数部分最多为8位,小数点1位,小数部分为2位,若小数部分为0,则小数点和小数部分可以省略。计量单位为人民币元。数据类型
5、记为DECIMAL,最大长度为11。l 单价:DDDDDDDD.DD,,整数部分最多为8位,小数点1位,小数部分最多为2位,若小数部分为0,则小数点和小数部分可以省略。计量单位为人民币元。数据类型记为DECIMAL,最大长度为11。l 数量:DDDDDDDD.DD,8位整数,2为小数。小数部分为0,小数点和小数部分可以省略,最大长度11位。数据类型记为QUANTITY。l 其他数据请参照数据字典。3.3 接口参数格式3.3.1 请求参数请求参数为标准XML字符串,顶层节点名称为Request,其下节点包括头部Header及数据Body两部分,具体格式如下: 应用Key 请求方法 接口方法版本
6、参数签名 请求时间 流水号 标签名数据类型中文名称必填项说明appCodeString请求应用的Code是接入方应用分配的应用CodesessionIdString会话ID或者Token是methodString请求的方法是versionString接口版本否signString参数签名否reqTimeString请求时间戳是reqTraceNoString流水号是3.3.2 响应参数响应参数为标准Xml字符串,顶层节点名称为Response,其下节点包括头部Header节点及响应数据Body两部分,具体格式如下: 结果值编码 结果描述 结果详细描述 标签名数据类型中文名称必填项说明codeS
7、tring结果值编码是见字典(提示信息)msgString结果消息否见字典(提示信息)detailString结果详细描述否结果详细描述,错误时可以提供respTimeDateTime响应时间是格式:yyyy-mm-dd HH:mm:ss 备注当响应参数包括多个子项时,子项内容父节点为items,各子项内容节点为item。 头部公共响应参数 . 3.4 接口访问地址http:/120.76.223.229:1080/sayifpf/webService/FdaWsOutsideEntrance?wsdl 4 接口逻辑结构设计4.1 微信预约平台接口架构4.2 体检业务监控接口架构5 接口详细参
8、数和格式5.1 数据签名验证5.1.1 数字签名生成功能接口webservice接口方法CallFun请求方法(method)900100(见接口功能编号字典)接口描述数字签名生成接口接口协议webservice+xml加密算法MD55.1.1.1 请求消息 头部公共请求参数 标签名必填类型说明METHOD是String接口业务类型(见接口功能编号字典)ORGCODE是String机构编码USER是String用户名PASSWORD是String用户接口密码,加密:MD5UUID是String系统对接前,分配给机构的UUID,相当于身份唯一识别码5.1.1.2 返回消息 头部公共响应参数 标签
9、名类型说明SIGNATUREString数字签名,该签名用于业务接口调用的认证码生成,数字签名具有时效性5.2 微信端接口5.2.1 体检机构信息接口webservice接口方法CallFun请求方法(method)C00100(见接口功能编号字典)接口描述体检登记接口接口协议webservice+xml加密算法MD5+Base645.2.1.1 请求信息头部公共请求参数 标签名是否必填类型说明METHOD是String接口业务类型(见接口功能编号字典)ORGCODE是String机构编码CHECKUUID是String接口验证认证码,用于和服务器验证接口访问的合法性,该认证码依据数字签名以及参数值排序相应规则生成SNAME否String机构简称NAME否String机构名称ADDRESS否String地址5.2.1.2 返回消息 头部公共响应参数 WORK_SC