健康证管理平台-广东食品药品监督管理局.docx
广东省食品从业人员健康检查管理平台接口规范文档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健康证打印接口19短信通知上传接口21脸血人比对分析236 附录：字典256.1 接口功能编号25广东省食品从业人员健康检查管理平台接口规范文档1概述健康证管理平台根据省局关于体检机构现场巡查和体检业务实时监控的要求制定。目的是实时获得体检机构的实时业务监控数据，保证服务业从业人员的体检信息的真实性。主要实时监控如下：WQ机构的Q嶷线和筋丁仃4纣忧(tfH)(twa)()(ti>)(u)<<!O)(fffft)(m)检站m%吟(tf¾)健康证管理平台供应Wcbscrvice接口应用服务，供各接入系统访问调用.在调用时，需根据本文档规定格式拼装参数，传入参数调用平台端WebSerViCe接口，接收WebSerViCe接口获得返回信息。各接入系统将返回信息进行解析后供自身系统处理运用.2适用范围本文档主要用于描述MbSeryiCe接口的定义、调用说明。文档可供接入健康证管理平台的各系统建设方、开发方阅读及运用。3接口概述3.1 接口概述健康证管理平台作为服务端，以WebSerViCe方式为各个第三方系统等供应接口服务.接口采纳SOAP协议，恳求方在恳求时以bas064加密入参，服务器解密处理，返回bse64加密回参，恳求端自行解密运用。WebSerViCe接口统一入口方法为CanFUn,通过method参数进行业务区分。3.2 数据类型与格式如无特别说明，木文档中的部分数据均为以下格式： H期：YYYY-MM-DD.即4位年，2位月份.2位日期.数据类型记为DATE,长度为10. 时间：HH：MM:SS.即2位小时（24小时制.2为分钟,2为佻数据类型记为TIME.长度为6. 口期时间:YYYY-MM-DDHH：MMSS.数据类型记为DATETIME,长度为19. 帝厘秒日期时间：YYYY-MM-DDHH：MM：SS：FFF.FFF为宝秒数.数据类型记为DATET1.ME,长度为17, 金额：DDDDDDDD.DD.倍数部分最多为8位.小数点1位,小数部分为2位，若小数部分为0,则小数点和小数部分可以省略.计量单位为人民币元.数据类型记为DECWA1.,G大长度为11， 单价：DDDDDDDD.DD.整数部分最多为8位,小数点1位小数部分最多为2位，若小数部分为0,则小数点和小数部分可以省略，计/单位为人民币元。数据类型记为DEQMA1.,拼大长度为II, 数fit：DDDDDDDD.DD.8位整数，2为小数,小数部分为Q小数点和小数部分可以省略，最大长度11位，数据类型记为QUANTn'丫。 其他数据请参照数据字典.3.3 接口参数格式3.3.1 恳求参数恳求参数为标准Xv1.字符串，顶层节点名称为ReqUeSt,其卜节点包括头部Header及数据BOdy两部分，具体格式如下：REQUESTVHEADKR>VApPC'ODE>应用KEY<APPCODE><SESSION1.1.>><SESSION1.1.>>VMETHOD>求方法/METHOD<VERSI()>H口方法版本<VKRS1.oN>VSIG>数签名<SIG>VRKQTIM卜：>愚求时同<REQTIME>VREQTIMC卜：、0>流水号VREQTRACEN(>><HKAI)ER><BOI)Y><B()I)Y><REQUEST>标笠名数据类型中文名称必填项说明appCodeString恳求应用的Code是接入方应用安排的应用CodeSessionIdString会话ID或者Token是methodString恳求的方法是versionString接口版本否SignSiring参数签名否reqTimeString恳求时间裁是reqTraceNoString流水号是3.3.2 响应参数晌应参数为标准Xm1.字符曲.顶层节点名称为RCSPOnSa其下节点包括头部Header节点及响应数据BOdy两部分，具体格式如下：RESPONSE(HEADER)<CODE>fJftffif<CODE><MSG>结果描述"MSG><DETI1.>果具体描述VfDETA11.<RESPTME><RESPTME><HEADER><BODY><BODY><RESPONSF>标筌名数据类型中文名称必填项说明codeString结果值编码是见字典（提示信息msgString结果消息否见字典（提示信息）detai1.String结果具体描述否结果具体描述，错误时可以供应respTimeDateTime晌应时间是格式：yyyy-0n-ddHH：mm：ss备注当响应参数包括多个f项时子项内容父节点为i1.cms各子项内容笆点为诵E1.RESPONSE)<HEADER>头部公共响jSt<HEADMR><BOI)Y><1TEMS><1TEM><II)><D><NAME><NMK><TKM><ITEMS><BOOY><R1.SPOSE>3.4接口访问地址:/120.76,223.229:1080/SayifPfyWebSerViCe/FdaWsOutSideEntrance?wsd1.4接口逻辑结构设计4.1 微信预约平台接口架构4.2 体检业务监控接口架构体,凯杓械n伟校:务实“抬拄线I】5接口具体参数和格式5.1 数据签名验证5.1.1 数字签名生胜利能接口webservice接1方法Ca11Fun恩求方法（method）WO1.OO（见接口功能编号字典接11描述数字签名生成接口接口协议WebSerYiCexm1.加密算法MD55.1.1.1 恳求消息<REQUESr><HEAI>HR>头部公共恳求参数<HEANR>CBoDY><MET1IOD><METHOD><ORGC()I)E><ORGC()I)1.><USER><USER><PSSU'ORD><PSS'ORD><UUID><UUID><BOI>Y>/REQUEST标签名必填类型说明METHOD是String接口业务类型见接口功能编号字典）ORGCODE是String机构编码USER是String用户名PASSWORD是String用户接口密码，加密：MD5UUID是String系统对接前，安排给机构的UUn>,相当于身份唯一识别码5.1.1.2 返回消息<RESPONSE>CHE,U三>头部公共响应参数</HEAM：R><BOOY><SIGNAT1.REXZSIGNAniRE><BOY></RESPONSE>标笠名类型说明SIGNATUREString数字签名，该签名用于业务接口调用的认证码生成，数字签名具有时效性5.2 微信端接口5.2.1 体检机构信息接口webservice接口方法Ca1.IFUn恳求方法（method）COO1.OO（见接11功能编号字典）接口描述体检登记接口接口协议webservice+xm1加诙算法MD5+Base645.2.1.1 恳求信息<REQUEST>VHEADERA头部公找恳求参数<HEADER><BODY><METHODxzTvfETHOD><ORGCODExORGCODE><CHECKUUIDx>,CHECKUUID><SNAME><SNAME>VNAMEXNAME><ADDRESS><ADDRESS><,<BODY>REQUEST标签名是否必填类型说明METHOD½String接口业务类型（见接口功能端号字典）ORGCODE是String机构编码Checkuuid是String接口蛤证认证码，用于和服务器依证接口访问的合法性.该认证码依据数字签名以及参数俄排序相应规则生成SNAME否String机构简称NAME否String机构名称ADDRESS否String地址5.2.1.2 返回消息<RESW)NSE><HEADER>头部公共响应参数<HEADER><BODY>VRESU1.TXRESU1.T><REMESSAGE><REMESSAGE><ORG1D><.ORGID><STTUSXSTATUS><CODE><CODE><NME><NME><SNAME><SNAME><P1CxP1C><ORG-CODE><ORG_CODE><REG!ONX7REGION><ADDRESS><ADDRESS><HED><'HEAD><MOB!1.E><MOBI1.E><1.ATX1.AT><1.NG><1.NG><SUPERV!SEXSUPERV1SE><MTIME><.,MTIME>VRECOMMENDxJRECoMMEND><VORK_SCHEDU1.E>v/WORK_SCHEDU1.E>VSCoREXSCoRE><EVA1.,SCORE><yEVA1.SCORE><EV1.TIMES><.'EVA1.,TIMES><STAT1.SxSTATUS><BODY><RESPONSE>标筌名类型说明RESU1.TString接调用结果:SUeCESS,FAI1.ED,ERRORRIiMESSAGEString接11返回消息ORGIDString业务机构唯一码CODEString机构编码NAMEString机构名称SN
