H5交互示意图

h5 接入流程

h5 联调测试流程

1、申请测试 partner和partner_key,并参考基本注意事项。

2、构造 H5登录入口 的URL,并加载对应页面。

3、提供第三方接口用于接收医生回复通知问题关闭通知(可选)。

4、调用H5的问题查询相关接口,进行问题查询(可选)。

5、测试完毕后,联系春雨人员开通正式环境账户后即可,第三方需要提供接收业务警报的邮箱地址。

h5 注意事项

1、H5入口页面第三方客户可以修改logo,但是需要保证春雨LOGO露出。第三方提供最终设计方案(JPG或PNG格式,尺寸 500*90)给春雨,由春雨相关人员配置上线。

2、用户可以自定义LOGO下面的文字内容,需要将文本内容提供给春雨相关人员进行配置。

3、用户可以更改H5页面的主色调,将色调值(例如#129aee)提供给春雨相关人员进行配置。

标准H5

(标准H5首页图片)

春雨提供给每一个合作商一个特定partner_key值,partner_key为春雨的加密密钥。合作商访问h5服务的时候,提供自定义的user_id来标识每一个用户。使用partner_key、时间戳以及user_id加密生成sign,完成h5服务的验证。查看加密方式

正确的URL格式: /cooperation/wap/login/?user_id=A800130&atime=1467098815&partner=chunyu_test&sign=5afda19c5d65a7a7

URL: /cooperation/wap/login/

请求方式: GET

请求参数:

名称 说明 类型 长度 必要 备注
user_id 用户名 String 32 用户唯一标识,合作方定义(可为字母、数字、下划线或其组合)
partner 合作方标识 String 32 我要申请
sign 签名 String 32 必须在服务器端生成 生成方法
atime 签名时间戳 Long 64 当前UNIX TIMESTAMP签名时间戳 (如:137322417)
entrance_type 入口类型 String pay:表示付费h5入口
free:表示免费h5入口
free_ask:表示免费问题的创建页面

返回: h5页面

商务售卖版H5

(商务售卖版H5首页图片)

春雨提供给每一个合作商一个特定partner_key值,partner_key为春雨的加密密钥。合作商访问h5服务的时候,提供自定义的user_id来标识每一个用户。使用partner_key、时间戳以及user_id加密生成sign,完成h5服务的验证。查看加密方式

正确的URL格式: /cooperation/wap/business/login/?user_id=A800130&atime=1467098815&partner=chunyu_test&sign=5afda19c5d65a7a7

URL: /cooperation/wap/business/login/

请求方式: GET

请求参数:

名称 说明 类型 长度 必要 备注
user_id 用户名 String 32 用户唯一标识,合作方定义(可为字母、数字、下划线或其组合)
partner 合作方标识 String 32 我要申请
sign 签名 String 32 必须在服务器端生成 生成方法
atime 签名时间戳 Long 64 当前UNIX TIMESTAMP签名时间戳 (如:137322417)

返回: h5页面

SaaS版H5

(SaaS版H5首页图片)

春雨提供给每一个合作商一个特定partner_key值,partner_key为春雨的加密密钥。合作商访问h5服务的时候,提供自定义的user_id来标识每一个用户。使用partner_key、时间戳以及user_id加密生成sign,完成h5服务的验证。查看加密方式

正确的URL格式: /open-platform/m-saas/home/?user_id=A800130&atime=1467098815&partner=chunyu_test&sign=5afda19c5d65a7a7

URL: /open-platform/m-saas/home

请求方式: GET

请求参数:

名称 说明 类型 必要 备注
user_id/phone 用户标识 string
partner 合作方标识 string 我要申请
sign 签名 string 必须在服务器端生成 生成方法
atime 时间戳 long 当前UNIX TIMESTAMP签名时间戳 (如:137322417)
strategy_key 策略标识 string 线下提供

返回:

无,跳转目标页面

回调管理

1.服务关闭和服务退款两个通知并不互斥,在特殊场景中(特殊情况:已交互的问题被举报时)会先关闭服务;
2.各类服务都可调用该接口,如同时接入多种服务类型,传不同的参数即可,根据status区分来自哪种服务类型。

URL: 即合作方登陆管理后台在上图位置填写的关闭回调路径

请求方式: POST

请求参数:

名称 说明 类型 长度 必要 备注
problem_id 问题编号 api接入返回Int,web接入返回加密的string
user_id 用户名 String 32 用户唯一标识,合作方定义
content 医生答复内容 String 数据结构,可以包含除 patient_meta 之外的三种类型。
sign 签名 String 32 生成方法 将生成方法中user_id换成problem_id,其他不变
atime 签名时间戳 Long 64 当前UNIX TIMESTAMP签名时间戳 (如:137322417)
doctor 医生信息 dict 医生信息
id 医生 ID String
name 医生姓名 String 200
image 医生头像 String 200 医生照片的 url
title 医生职称 String
level_title 带医院级别的医生职称 String 带医院级别的医生职称
clinic 科室名称 String 20
clinic_no 科室号 String 20
hospital 医院名字 String 100
hospital_grade 医院级别 String 医院级别
good_at 擅长领域 String 擅长领域
education_background 教育背景 String

返回:

名称 说明 类型 长度 必要 备注
error 错误码 Int 32 0 代表成功,其它 代表异常
error_msg 异常信息 String
{
            "error": 0, // 0 代表成功,其它 代表异常
            "error_msg": "" //错误信息
        }

服务关闭通知接口

URL: 合作方登录管理后台后在上图位置填写

请求方式: POST

请求参数:

名称 说明 类型 长度 必要 备注
problem_id 问题编号 api接入返回Int,web接入返回加密的string
user_id 用户名 String 32 用户唯一标识,合作方定义
msg 消息内容 String
status 问题状态 String

close 回答完毕后关闭

refund 问题退款

price 退款金额 Int 单位为分
sign 签名 String 32 生成方法 将生成方法中user_id换成problem_id,其他不变
atime 签名时间戳 Long 64 当前UNIX TIMESTAMP签名时间戳 (如:137322417)
refund_type 退款类型 Int 返回值及其类型说明:
1代表:医生拒绝
2代表:用户取消
3代表:超时退款
4代表:客服退款
5代表:被举报退款

返回:

名称 说明 类型 长度 必要 备注
error 错误码 Int 32 0 代表成功,其它 代表异常
error_msg 异常信息 String
{
            "error": 0, // 0 代表成功,其它 代表异常
            "error_msg": "" //错误信息
        }