《健康证管理平台-广东食品药品监督管理局.docx》由会员分享,可在线阅读,更多相关《健康证管理平台-广东食品药品监督管理局.docx(24页珍藏版)》请在优知文库上搜索。
1、广东省食品从业人员健康检查管理平台接口规范文档2017-11改版记录JK*发布日期描述作者复审批准1.02017/11/24建立该文档,初稿变更记录交更一号日期描述基线版本变更求号书目1 概述42 适用越阳.43 接口概述43.1 接口概述.43.2 数据类型与格式53.3 接口参数格式5恳求参数5响应参数63.4 接口访问地址84 接口逻辑结构设计84.1 微信预约平台接口架构84.2 体检业务监控接口架构85 接口具体参数和格式95.1 数据签名验SE9数字签名生胜利能接口95.2 微信端接口10体检机构信息接口105.3 体检系统接口13体检登记13体检结果体检明细接口16健康证打印接口
2、19短信通知上传接口21脸血人比对分析236 附录:字典256.1 接口功能编号25广东省食品从业人员健康检查管理平台接口规范文档1概述健康证管理平台根据省局关于体检机构现场巡查和体检业务实时监控的要求制定。目的是实时获得体检机构的实时业务监控数据,保证服务业从业人员的体检信息的真实性。主要实时监控如下:WQ机构的Q嶷线和筋丁仃4纣忧(tfH)(twa)()(ti)(u)VApPCODE应用KEYVMETHOD求方法/METHODH口方法版本VSIG数签名VRKQTIM卜:愚求时同VREQTIMC卜:、0流水号VREQTRACEN(标笠名数据类型中文名称必填项说明appCodeString恳求
3、应用的Code是接入方应用安排的应用CodeSessionIdString会话ID或者Token是methodString恳求的方法是versionString接口版本否SignSiring参数签名否reqTimeString恳求时间裁是reqTraceNoString流水号是3.3.2 响应参数晌应参数为标准Xm1.字符曲.顶层节点名称为RCSPOnSa其下节点包括头部Header节点及响应数据BOdy两部分,具体格式如下:RESPONSE(HEADER)fJftffif结果描述MSG果具体描述VfDETA11.标筌名数据类型中文名称必填项说明codeString结果值编码是见字典(提示信息
4、msgString结果消息否见字典(提示信息)detai1.String结果具体描述否结果具体描述,错误时可以供应respTimeDateTime晌应时间是格式:yyyy-0n-ddHH:mm:ss备注当响应参数包括多个f项时子项内容父节点为i1.cms各子项内容笆点为诵E1.RESPONSE)头部公共响jSt3.4接口访问地址:/120.76,223.229:1080/SayifPfyWebSerViCe/FdaWsOutSideEntrance?wsd1.4接口逻辑结构设计4.1 微信预约平台接口架构4.2 体检业务监控接口架构体,凯杓械n伟校:务实“抬拄线I】5接口具体参数和格式5.1
5、数据签名验证5.1.1 数字签名生胜利能接口webservice接1方法Ca11Fun恩求方法(method)WO1.OO(见接口功能编号字典接11描述数字签名生成接口接口协议WebSerYiCexm1.加密算法MD55.1.1.1 恳求消息HR头部公共恳求参数CBoDYY/REQUEST标签名必填类型说明METHOD是String接口业务类型见接口功能编号字典)ORGCODE是String机构编码USER是String用户名PASSWORD是String用户接口密码,加密:MD5UUID是String系统对接前,安排给机构的UUn,相当于身份唯一识别码5.1.1.2 返回消息CHE,U三头部
6、公共响应参数标笠名类型说明SIGNATUREString数字签名,该签名用于业务接口调用的认证码生成,数字签名具有时效性5.2 微信端接口5.2.1 体检机构信息接口webservice接口方法Ca1.IFUn恳求方法(method)COO1.OO(见接11功能编号字典)接口描述体检登记接口接口协议webservice+xm1加诙算法MD5+Base645.2.1.1 恳求信息VHEADERA头部公找恳求参数,CHECKUUIDVNAMEXNAME,REQUEST标签名是否必填类型说明METHODString接口业务类型(见接口功能端号字典)ORGCODE是String机构编码Checkuui
7、d是String接口蛤证认证码,用于和服务器依证接口访问的合法性.该认证码依据数字签名以及参数俄排序相应规则生成SNAME否String机构简称NAME否String机构名称ADDRESS否String地址5.2.1.2 返回消息头部公共响应参数VRESU1.TXRESU1.TVRECOMMENDxJRECoMMENDv/WORK_SCHEDU1.EVSCoREXSCoRE标筌名类型说明RESU1.TString接调用结果:SUeCESS,FAI1.ED,ERRORRIiMESSAGEString接11返回消息ORGIDString业务机构唯一码CODEString机构编码NAMEString机构名称SN