• 账号不存在 春雨会为该用户创建一个新账号,并登陆
• 账号已存在 春雨为当前用户执行登录操作，不必每次请求，新用户只要同步过一次即可

URL: /cooperation/server/login

请求方式: POST

请求参数:

名称	说明	类型	长度	必要	备注
user_id	用户名	String	32	是	用户唯一标识,合作方定义（可为字母、数字、下划线或其组合）
password	密码	String	32	是
lon	经度	String		否	例如: 北京 lon = '116.3'
lat	纬度	String		否	例如: 北京 lat = '39.9'
partner	合作方标识	String	32	是	我要申请
sign	签名	String	32	是	必须在服务器端生成 生成方法
atime	签名时间戳	Long	64	是	当前UNIX TIMESTAMP签名时间戳 (如:137322417)

返回:

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

            
              {
                "error": 0, // 0 代表成功,其它 代表异常
                "error_msg": ""
                 //错误信息}
              
            
          

简介

快捷电话是针对用户提供的一种便捷快速的落地电话服务。

用户购买本服务时，需指定待咨询的科室，并提供便于接听的电话号码，支付成功后，由平台侧医助与用户电话确认需求后，建立起医患之间一对一的通话服务。

服务细则

• 通话时长

  正常通话满10分钟（心理科除外）自动关闭，心理科满20分钟自动关闭

• 服务时间段

  正常服务时间段为：工作日9:00 - 21:00，周末及假期9:00 - 19:00。在服务时间段外创建的订单，将由医助在服务时间内联系用户

• 未拨通的处理方式

  用户用户：平台医助会重播2~3次，持续无接听则由医助进行退款

  医生原因：医生工作繁忙，利用业余时间提供咨询，预计拨打时间可能会有延迟。如未能接通医生，医助会尝试协调其他时间或者由其他医生提供服务，如用户认可则继续服务，如用户拒绝则退款

• 意外中断

  如果通话过程意外中断，医生会联系平台重建通话，用户也可拨打春雨客服电话400-001-8855反馈重连

• 医生发送总结

  通话完成后24h内，医生可以无限次以图文形式给用户发总结，医生只在有必要时才会总结

• 服务价格

  服务价格以商务合同中敲定的为准，在接口参数中不做体现

服务接入建议

• 平台拨出号码为010-59164500，合作方可在自有产品上向用户进行友情提示，防止用户拒接
• 平台会在拨打时间给用户打电话，请提醒用户确保填写的接听手机号码可以正常通话，注意接听
• 请用户根据病情复杂程度选择合适长度的电话服务，为保证咨询通话效率，建议事先准备好病情材料（如相关检查报告照片）
• 电话接通后，医助会指导用户下一步操作，用户根据医助提示操作即可
• 医助通过三方通话平台联系医生和用户，双方电话号码保密，不会让用户直接拨打医生电话/医生拨打用户电话

获取快捷电话信息接口

说明：获取春雨快捷电话开通的科室

URL: /cooperation/server/phone/get_fast_phone_info/

请求方式:POST

请求参数:

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

返回:

名称		说明	类型	长度	必要	备注
error		错误码	Int	32	是	0 成功,1 失败
clinic_info		科室信息list	Array		否
	clinic_no	科室号	str	10
	clinic_name	科室名	str	32
	icon	图标	str	100		科室对应的图标

创建快捷电话接口

说明：在用户成功付款后，调用此接口生成快捷电话订单，正常服务时间为9:00- 21:00，此时间段以外时间创建的订单需等正常工作时间后医助会联系用户

URL: /cooperation/server/phone/create_fast_phone_order/

请求方式:POST

请求参数:

名称	说明	类型	长度	必要	备注
user_id	用户ID	String	32	是	用户唯一标识,合作方定义（可为字母、数字、下划线或其组合）
partner	合作方标识	String	32	是	partner_name
sign	签名	String	32	是	必须在服务器端生成 生成方法
atime	时间戳	Long	64	是	当前UNIX TIMESTAMP签名时间戳 (如:137322417)
partner_order_id	合作方支付ID	String	32	是	唯一标识本次支付行为
clinic_no	科室号	String	10	是	必须是春雨开通的科室
phone	用户手机号	String	11	是
content	电话补充描述内容	String	5120	是	数据结构,其中 patient_meta 不能传递多次,以第一次内容的为准。

返回:

名称	说明	类型	长度	必要	备注
service_id	服务id	Int	32	是	创建的快捷电话ID
error	错误码	Int	32	是	0 成功,1 失败
error_msg	错误原因	String		否

快捷电话推送接口

说明：用于接收快捷电话订单关闭状态及通话医生信息

URL：同合作方提供的服务关闭通知接口

请求方式:POST

请求参数:

名称		说明	类型	长度	必要	备注
service_id		快捷电话订单id	String	32	是
sign		签名	String	32	是	必须在服务器端生成 生成方法
atime		时间戳	Long	64	是	当前UNIX TIMESTAMP签名时间戳 (如:137322417)
status		推送状态	String	32	是	'fast_phone_close' 正常结束 'fast_phone_refund' 订单退款
msg		错误信息	String	10	是	必须是春雨开通的科室
user_id		用户ID	String	32	是	用户唯一标识,合作方定义（可为字母、数字、下划线或其组合）
user_id		用户ID	String	32	是
doctor		医生信息	object		是	格式见下方
	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		是	擅长领域（医生回复接口里的医生信息是简版的信息，建议通过医生详情接口获取医生的详细信息）

快捷电话医生总结推送接口

说明：通话完成后24h内医生可以无限次以图文形式给用户发总结，医生只在有必要时才会总结

URL：复用合作方提供的医生回复通知接口

请求方式:POST

请求参数:

名称		说明	类型	长度	必要	备注
user_id		用户ID	String	32	是	用户唯一标识,合作方定义（可为字母、数字、下划线或其组合）
service_id		快捷电话订单id	String	32	是
sign		签名	String	32	是	必须在服务器端生成 生成方法
atime		时间戳	Long	64	是	当前UNIX TIMESTAMP签名时间戳 (如:137322417)
status		推送状态	String	32	是	'telephone_summary' 定向电话总结 'fast_phone_summary' 快捷电话总结
content		数据格式			是	数据结构,其中 patient_meta 不能传递多次,以第一次内容的为准。
user_id		用户ID	String	32	是	用户唯一标识,合作方定义（可为字母、数字、下划线或其组合）
doctor		医生信息	object		是	格式见下方
	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		否

用户追问接口

说明：通话前可以添加追问，调用此接口追加病情描述

URL:/cooperation/server/phone/add_content/

请求方式:POST

请求参数:

名称	说明	类型	长度	必要	备注
user_id	用户ID	String	32	是	用户唯一标识,合作方定义（可为字母、数字、下划线或其组合）
partner	合作方标识	String	32	是	partner_name
sign	签名	String	32	是	必须在服务器端生成 生成方法
atime	时间戳	Long	64	是	当前UNIX TIMESTAMP签名时间戳 (如:137322417)
service_id	电话订单id	String	32	是
content	提问内容	String	5120	是	数据结构,其中 patient_meta 不能传递多次,以第一次内容的为准。
service_type	电话服务类型	String	10	是	电话订单类型： inquiry表示定向电话订单； fast_phone表示快捷电话订单； 本接口传fast_phone

返回:

名称	说明	类型	长度	必要	备注
error	错误码	Int	32	是	0 成功,1 失败
error_msg	原因	String		否

简介

指用户付费购买指定医生的电话咨询服务。

用户购买指定时长的服务后，医生将以电话形式提供明确、放心的诊疗建议。

接入流程

需要注意的是：

1.关于追问：通话成功1h内且医生未回复的情况下，用户可以进行追问；

2.关于总结：通话完成后24h内医生可以无限次总结；

3.订单创建成功后，首次拨打失败，5分钟后会自动重拨；

4.正常通话后客服人工重连逻辑：购买普通医生通话不足1分钟电话挂断、或购买名医通话不足5分钟挂断 客服会介入询问用户是否需要人工重连；

获取医生电话信息接口

说明：获取医生最近可拨打电话时间，及价格配置

URL:/cooperation/server/phone/get_doctor_phone_info/

请求方式:POST

请求参数:

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

返回:

名称	说明	类型	长度	必要	备注
error	错误码	Int	32	是	0 成功,1 失败
error_msg	错误原因	String		否
recent_subscribable_time	最近可预约时间	String	64	否	格式："%Y-%m-%d %H:%M"
price_info	医生价格信息	object	64	否	{minutes:price(元)},如 {'5': 10, '10': 20}
subscribable_time_list	可预约时间列表	list	64		string list，格式同recent_subscribable_time

创建预约电话接口

说明：在用户成功付款后，调用此接口创建预约电话

URL: /cooperation/server/phone/create_oriented_order/

请求方式:POST

请求参数:

名称	说明	类型	长度	必要	备注
user_id	用户ID	String	32	是	用户唯一标识,合作方定义（可为字母、数字、下划线或其组合）
partner	合作方标识	String	32	是	partner_name
content	电话补充描述内容	String	5120	是	数据结构,其中 patient_meta 不能传递多次,以第一次内容的为准。
sign	签名	String	32	是	必须在服务器端生成 生成方法
atime	时间戳	Long	64	是	当前UNIX TIMESTAMP签名时间戳 (如:137322417)
partner_order_id	合作方支付ID	String	32	是	唯一标识本次支付行为
doctor_id	医生id	String	64	是
minutes	拨打时长	int	32	是	共有10，15，20，30四个时间长度，具体取决于医生是否配置了相应的时间长度
tel_no	用户电话	String	11	是	将拨打此电话
price	价格（元）	int	32	是	订单价格
inquiry_time	预约时间	String	32	是	格式如"2018-01-28 09:30"

返回:

名称	说明	类型	长度	必要	备注
service_id	电话服务id	Int	32	否	创建的服务id
inquiry_time	拨打时间	String	32	否	格式如"2018-01-28 09:30"
error	错误码	Int		是	0 成功,1 失败
error_msg	错误原因	String		否

用户取消订单接口

说明：用户在预约电话开始前调用此接口取消订单

URL:/cooperation/server/phone/user_cancel/

请求方式:POST

请求参数:

名称	说明	类型	长度	必要	备注
user_id	用户ID	String	32	是	用户唯一标识,合作方定义（可为字母、数字、下划线或其组合）
partner	合作方标识	String	32	是	partner_name
sign	签名	String	32	是	必须在服务器端生成 生成方法
atime	时间戳	Long	64	是	当前UNIX TIMESTAMP签名时间戳 (如:137322417)
service_id	电话订单id	String	32	是
cancel_reason	取消原因	String	100	是

返回:

名称	说明	类型	长度	必要	备注
error	错误码	Int	32	是	0 成功,1 失败
error_msg	原因		否	String

用户追问接口

说明：通话成功1小时内且医生未回复时可以追问，调用此接口追加病情描述

URL:/cooperation/server/phone/add_content/

请求方式:POST

请求参数:

名称	说明	类型	长度	必要	备注
user_id	用户ID	String	32	是	用户唯一标识,合作方定义（可为字母、数字、下划线或其组合）
partner	合作方标识	String	32	是	partner_name
sign	签名	String	32	是	必须在服务器端生成 生成方法
atime	时间戳	Long	64	是	当前UNIX TIMESTAMP签名时间戳 (如:137322417)
service_id	电话订单id	String	32	是
content	提问内容	String	5120	是	数据结构,其中 patient_meta 不能传递多次,以第一次内容的为准。
service_type	电话服务类型	String	10	是	电话订单类型： inquiry表示定向电话订单； fast_phone表示快捷电话订单； 本接口传inquiry

返回:

名称	说明	类型	长度	必要	备注
error	错误码	Int	32	是	0 成功,1 失败
error_msg	原因	String		否

用户评价接口

说明：电话结束后，用户评价电话服务，可评价有效期为电话关闭后30天(测试服1小时)内可以评价

URL:/cooperation/server/phone/assess/

请求方式:POST

请求参数:

名称		说明	类型	长度	必要	备注
user_id		用户ID	String	32	是	用户唯一标识,合作方定义（可为字母、数字、下划线或其组合）
partner		合作方标识	String	32	是	partner_name
sign		签名	String	32	是	必须在服务器端生成 生成方法
atime		时间戳	Long	64	是	当前UNIX TIMESTAMP签名时间戳 (如:137322417)
service_id		电话订单id	String	32	是
assess_info		评价信息	String		是	数据结构,生成方式可参考数据结构 如:'{"level": "best", "tag_keys":["3201", "3102"]}'
	level	评价等级	String	10	是	'best','good','bad'
	tag_keys	评价标签数组	Array		是	标签必须与 level 匹配
remark		评语	String		否

    
      
        {
          "bad": {
          "1302": '不专业',
          "1101": '不友好',
          "1303": '没帮助',
          "1301": '听不懂',
          "1201": '信号不好',
          "1203": '接通了没声音',
          "1202": '没讲完就中断了',
          "1204": '不是医生本人接电话',}
        "good": {
          "2101": '希望更有耐心',
          "2102": '希望态度更友好',
          "2201": '信号不好',
          "2301": '希望讲得更透彻',
          "2103": '没讲完就中断了',}
        "best": {
          "3101": '态度非常好',
          "3102": '讲解很清楚',
          "3103": '很有耐心',
          "3301": '非常专业认真',
          "3302": '意见很有帮助',
          "3104": '很细心',}
        }
      
    
  

返回:

名称	说明	类型	备注
error	结果	Int	0 成功,1 失败
error_msg	原因	String

推送接口（回调）

说明：同合作方提供的服务关闭通知接口

URL:合作方提供

请求方式:POST

请求参数:

名称	说明	类型	长度	必要	备注
user_id	用户ID	String	32	是	用户唯一标识,合作方定义（可为字母、数字、下划线或其组合）
sign	签名	String	32	是	必须在服务器端生成 生成方法
atime	时间戳	Long	64	是	当前UNIX TIMESTAMP签名时间戳 (如:137322417)
service_id	电话订单id	String	32	是
status	电话状态	String		是	'phone_close'为电话正常关闭, 'phone_refund'为电话退款
price	退款金额（退款）	int		是	分
msg	退款原因（退款）	String		是
call_duration	拨打时长（正常关闭）	int		是	分钟
first_dial_time	首次拨打时间	String		是	形如"2018-01-28 09:30"
finish_time	通话结束时间	String		是	形如"2018-01-28 09:30"

返回:

名称	说明	类型	长度	必要	备注
error	错误码	Int		是	0 成功,1 失败
error_msg	原因	String		否

医生总结推送接口（回调）

说明：通话完成后24h内医生可以无限次以图文形式给用户发总结，医生只在有必要时才会总结

URL:合作方提供，同医生回复推送接口

请求方式:POST

请求参数:

名称	说明	类型	长度	必要	备注
user_id	用户ID	String	32	是	用户唯一标识,合作方定义（可为字母、数字、下划线或其组合）
sign	签名	String	32	是	必须在服务器端生成 生成方法
atime	时间戳	Long	64	是	当前UNIX TIMESTAMP签名时间戳 (如:137322417)
service_id	电话订单id	String	32	是	服务id
status	电话状态	String		是	telephone_summary为定向电话医生总结，fast_phone_summary为快捷电话总结
content	医生回复内容	String	5120	是	数据结构,可以包含除 patient_meta 之外的三种类型
user_id	用户id	String	32	是
doctor	医生信息	dict		是	格式如下

名称		说明	类型	长度	必要	备注
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		否

电话详情接口

说明：第三方通过此接口查询电话订单详情

URL:/cooperation/server/phone/detail/

请求方式:POST

请求参数:

名称	说明	类型	长度	必要	备注
user_id	用户ID	String	32	是	用户唯一标识,合作方定义（可为字母、数字、下划线或其组合）
partner	合作方标识	String	32	是	partner_name
service_id	电话服务id	int	32	否	创建的服务id
sign	签名	String	32	是	必须在服务器端生成 生成方法
atime	时间戳	Long	64	是	当前UNIX TIMESTAMP签名时间戳 (如:137322417)

返回:

名称		说明	类型	长度	必要	备注
service_id		电话服务id	Int	32	是	创建的服务id
first_dial_time		首次拨打时间（首次拨打失败，5分钟后会自动重拨）	String	20	否	格式为yyyy-mm-dd hh:mm:ss
start_time		通话开始时间	String	20	否	格式为yyyy-mm-dd hh:mm:ss
finish_time		通话结束时间	String	20	否	格式为yyyy-mm-dd hh:mm:ss
call_duration		拨打时长（正常关闭）	int		是	单位为分钟
status		电话状态	String	5	是	s:已预约 d:电话医生拒绝 t:电话通话成功 o:电话连接失败 ca:电话已取消
assess_level		评价星级	String	32	是	'best','good','bad'
doctor_info		医生信息	object		是	格式见下方
	id	医生id	String		是
	name	医生姓名	String		是	name
	image	医生头像	String	200	是	医生照片的 url
	title	职称	String		是	title
	clinic_name	科室名称	String		是	clinic_name
	hospital_name	医院名称	String		是
	hospital_grade	医院等级	String		是
	error	错误码	int	32	是	0 代表成功,其它代表异常
	error_msg	异常信息	String		否	error_msg

相关文案

说明：异常情况时，春雨会推送对应文案

情况	系统推送文案
订单创建失败	医生近期繁忙，未能预约到24h内电话，支付费用已原路退回
首次拨打未接通	您的电话咨询暂未接通，系统将在5分钟后自动重拨
医生拒绝	医生已拒绝，原因：xxx，支付费用已原路退款
5分钟自动重拨未接通	电话未接通，支付费用已原路退款
同一手机号、同一时间预约成功其他医生	此时间已预约其他医生

服务使用说明文案（可用于展示给用户）：

服务流程：预约成功后，平台会在预约时间给您来电，号码为010-59164500，请注意接听

平台会在拨打时间给您打电话，请您确保填写的接听手机号码可以正常通话，注意接听

请您根据病情复杂程度选择合适长度的电话服务，为保证咨询通话效率，建议事先准备好病情材料（如相关检查报告照片）

医生工作繁忙，利用业余时间提供咨询，预计拨打时间可能会有延迟。如未能接通医生，将为您全额退款。

通话过程中如有意外挂断，请联系客服400-001-8855

常见错误码