预约挂号web前置接口说明文档V2.0.docVIP

预约挂号平台 接口说明文档（web前置） 文档修改记录 序号 修订日期 修订说明 编写者 审核者 1概述 1.1请求类 1.1.1接口定义 请求类统一接口为：http://[ip]:[port]/service/RPC web前置采用rpc协议，所有请求和响应对象均必须实现java Serializable序列化接口进行对象编解码 。 1.1.2接口描述 ip：服务接口主机IP，由平台统一提供。 port：服务接口主机端口，由平台统一提供。 URL：固定格式。 1.2通知类 1.2.1接口定义 服务商提供http方式回调请求地址，平台会根据跟地址向服务商发起通知。 1.2.2接口描述 1、服务商需要向平台提供固定的ip，port，url。 2、url：服务商提供，固定回调地址。例如：http://[ip]:[port]/notify/notify.htm 3、若服务商更改此URL地址，必须通知平台更新，否则无法通知成功。 2详解 2.1请求类 1)请求类方法请求的时候，公共部分请求对象(VoRequest)为所有请求对象的必填项。 2)请求类方法响应的时候，公共部分响应对象(VoResponse)为所有响应对象的返回项。 3)请求类统一调用接口名为：TransPort。 2.1.1公共部分 请求对象 VoRequest 序号 对象属性 长度 是否必填 类型 描述 1 providerCode 4 Y String 服务商编号，由平台统一提供 2 operNo =15 Y String 终端用户IP（网站等公网方式上送终端用户IP）或操作员编号（座席系统，上送操作员编号） 3 random 4 Y String 服务商验签所需的随机码，可由数字和字符组成 4 sign Y String 服务商验签密码，规则详见（3.1验签） 5 hopistalId 6 Y String 医院编号，由平台统一定义（查询医院概要信息时，该值上送999999） 响应对象 VoResponse 序号 对象属性 长度 是否必填 类型 描述 1 code 4 Y String 平台统一返回的枚举CODE值，详见（4枚举） 2 info Y String 平台统一返回的枚举DESC值，详见（4枚举） 3 success Y boolean 平台统一返回请求是否成功；true：请求成功，false：请求失败 2.1.2患者注册 方法名称 registed() 请求对象 PatientRegistedRequest（继承VoRequest） 序号 对象属性 长度 是否必填 类型 描述 1 tradeCode 6 Y String 注册交易码(100100) 2 patientName 20 Y String 姓名 3 patientIdCard 20 Y String 证件号 4 patientIdCardType 1 Y String 证件号类型 5 patientMediCard 24 N String 医保卡号 6 patientMediCardType 1 N String 医保卡类型 7 patientMobile 11 Y String 手机号 8 patientTele 12 N String 电话号码 9 patientAddr 100 N String 联系地址 10 patientPostCode 6 N String 邮编 11 patientSex 1 N String 性别 12 patientNation 2 Y String 民族 响应对象 PatientRegistedResponse（继承VoResponse） 序号 对象属性 长度 是否必填 类型 描述 1 patientId 10 Y String 返回患者平台唯一Id 2.1.3患者预约 方法名称 order() 请求对象 PatientOrderRequest（继承VoRequest） 序号 对象属性 长度 是否必填 类型 描述 1 tradeCode 6 Y String 注册交易码(100103) 2 patientId 10 Y String 平台唯一患者Id 3 numResourceId 10 Y String 平台唯一号源Id 4 tele 25 N String 主叫号码 响应对象 PatientOrderResponse（继承VoResponse） 序号 对象属性 长度 是否必填 类型 描