广东省医疗保障信息平台两定医药机构API接口接入指引.docxVIP

广东省医疗保障信息平台 两定医疗机构API接口 接入指引 为保障两定医药机构顺利接入广东省医疗保障信息平台（简称医保系统），并按时、按质、按量完成接口开发、联调、测试以及验收，特编制该文档，以供参考。 医疗机构接入步骤说明 医药机构医保专网验证 广东省医疗保障信息平台整体部署在政务云专网，两定医药机构需打通医保专网才能连接到医保系统以及两定API接口服务。 测试环境网关地址为：，开放IP地址为：06，开放端口为 443端口和80端口，调用时，域名地址与IP地址需要绑定配置HOST。 正式环境地址上线前另行通知。 医药机构接口改造开发 两定医药机构根据省医保局下发的接口规范文档，进行医药机构内部系统接口改造，按照新接口规范标准要求，调用医保API接口服务，需完全遵循接口规范进行接口入参传值。 申请联调测试 两定医药机构完成医保接口规范对接改造，且网络验证通过后，向地方医保局申请联调测试，地方医保局API接口负责人将配合两定医药机构完成接口联调测试工作。 联调申请表见附件。 接口验收工作 两定医药机构完成所有医保API接口服务联调测试通过后，向地方医保局申请接口验收，地方API接口负责人将对提交验收申请的医疗机构进行接口核验，核验通过后完成接口验收。 接口验收申请以及验收表见附件。 API接口调用服务说明 API接口调用地址 API接口调用服务地址示例为http:// {IP地址或域名:端口}/ {应用账户编码}/{服务开放路径} 具体IP地址或域名、端口、应用账户编码、服务开放路径以医保系统承建商提供为准。 API接口调用方式 Http请求方法：post Http MIME类型: Content-Type: application/json 表格 STYLEREF 1 \s 2服务请求头定义 序号 数据元标识 数据元名称 类型 长度 代码标识 是否必填 备注 x-tif-paasid 应用编码 字符型 100 Y 在创建账户时自动生成应用编码和密钥（secretKey私钥）。 x-tif-signature 签名 字符型 300 Y Sha256加密生成的签名。x-tif-signature = sha256(x-tif-timestamp + secretKey+ x-tif-nonce + xtif-timestamp) x-tif-timestamp 时间 时间戳 Y 当前 unix 时间戳（秒）。 x-tif-nonce 校验码 字符型 100 Y 非重复的随机字符串（十分钟内不能重复）。 API接口响应内容 API接口服务响应分为两类，一类是正常响应，一类是异常响应。 正常响应时，API接口服务直接把结果透传给调用者，不做任何操作。 异常响应时，API接口服务会返回{ errcode:xxx,,message:xxx}结构的json数据。 Code字段为状态码，message为异常信息。 常见异常响应有： 响应结果 解释 { errcode :401,message:缺少服务调用的请求头!} 请求中缺少服务调用所需的请求头。 { errcode :401,message:签名时间戳超时!} 时间戳超时，默认为30分钟。 { errcode :401,message:非法用户!} 请求头中携带的AK不是合法的AK { errcode :401,message:签名不一致!} 签名不一致,请检查您的签名方式 两定医药机构读卡说明 两定医药机构读卡动态库以及接口文档由省项目组统一下发给地市项目组，地市项目组收到读卡动态库以及接口文档后，及时下发给两定医药机构进行读卡开发改造。下发的接口动态库包含身份证读取、社保卡读取以及扫码接口内容。 读卡初始化地址： 测试环境：/gdyb_inf/poc/api/card/initDll 正式环境：/gdyb_api/prd/api/card/initDll 读卡动态库以及接口文档： 【1101】人员信息获取说明 电子凭证 通过扫描枪直接扫电子医保凭证，获取电子凭证号，通过【1101】接口，入参【mdtrt_cert_type】传值01，【mdtrt_cert_no】传值获取到的电子凭证号，即可通过接口获取到该电子凭证的参保人信息。每个电子凭证号只能被使用一次。 使用电子凭证办理业务，接口中的【mdtrt_cert_type】传值必须是01，【mdtrt_cert_no】传值必须是获取到的电子凭证号，不能随便填写。 身份证 通过手工输入身份证号或通过读卡设备读取身份证获取身份证号码，通过【1101】接口，入参【mdtrt_cert_type】传值02，【mdtrt_cert_no】传值身份证号码，即可通过接口获取到该参保人信息。 社保卡 本地以及省内异地读卡：通过读卡设备获取到