预约服务创建接口

预约服务创建接口

说明:在用户成功付款后,调用此接口创建专家预约服务

URL:/cooperation/server/register/create/

请求方式:POST

请求参数:

名称 说明 类型 必要 备注
user_id 用户ID string
partner 合作方标识 string
sign 签名 string
atime 时间戳 long
doctor_id 医生id String 医生id
phone 用户手机号 String
service_type 服务类型 String expert_call :专家电话 expert_register_apply:专家预约挂号
desc 病情描述 String
has_visit_doctor 是否医院就诊过 Bool
has_checkup 是否检查过 Bool
sex 性别 String
age 年龄 Int
problem_desc 想咨询医生的问题 String
image_list 图片列表 String json格式字符串
partner_order_id 订单id String
price_fen 医生服务价格 Int 价格单位:分

返回:

名称 说明 类型 必要 备注
error_code 错误码 int 正常返回0
error_msg 错误信息 string
service_id 服务id Int 创建的预约服务id

服务详情接口

服务详情接口

说明:第三方通过此接口查询专家服务订单详情

URL:/cooperation/server/register/detail/

请求方式:POST

请求参数:

名称 说明 类型 必要 备注
user_id 用户ID string
partner 合作方标识 string
sign 签名 string
atime 时间戳 long
service_id 服务id Int

返回:

名称 说明 类型 必要 备注
error_code 错误码 int 正常返回0
error_msg 错误信息 string
service_id 服务id Int 创建的预约服务id
service_type 服务类型 String expert_call :专家电话 expert_register_apply:专家预约挂号
service_type_verbose 服务类型文本 String
price_fen 订单价格 Int 单位:分
refund_price_fen 退款价格 Int 单位:分
task_status 任务状态 Int 5: 待处理 6: 受理中 7: 已预约 10: 已完成 15: 已终止
task_status_verbose 任务状态文本 String
cancel_reason 取消原因 String 订单取消后必传
service_info 服务信息
sms_content 短信内容 String
set_call_time 通话时间 String
status_msg 通话状态 String
call_result 通话结果 String
upload_link 材料上传及查看入口链接 String 用户侧嵌套 登录跳转使用
chat_link 与顾问聊天页面链接 String 用户侧嵌套 登录跳转使用
doctor 医生信息 Object 格式见下方
id 医生 ID String
name 医生姓名 String
image 医生头像 String 医生照片的 url
title 医生职称 String
clinic_name 科室名称 String
hospital_name 医院名字 String
hospital_grade 医院等级 String

服务取消接口

服务取消接口

说明:第三方通过此接口取消专家预约服务,备注:仅在 task_status为待处理时可取消服务

URL:/cooperation/server/register/cancel/

请求方式:POST

请求参数:

名称 说明 类型 必要 备注
user_id 用户ID string
partner 合作方标识 string
sign 签名 string
atime 时间戳 long
service_id 服务id Int
cancel_reason 取消原因 String

返回:

名称 说明 类型 必要 备注
error_code 错误码 int 正常返回0
error_msg 错误信息 string

任务状态更新回调

任务状态更新回调

说明:当专家预约服务在不同任务状态变更时,春雨主动请求合作方配置的链接地址,传递此次订单任务变化和相关信息。

URL:复用服务关闭回调路径(API对接图文问诊类 -- 回调管理 -- 服务关闭通知)

请求方式:POST

请求参数:

名称 说明 类型 必要 备注
user_id 用户ID string
sign 签名 string
atime 时间戳 long
service_id 服务id Int
service_type 服务类型 String expert_call :专家电话 expert_register_apply:专家预约挂号
status 回调类型 String 固定值 expert_service_update
task_status 任务状态 Int 5: 待处理 6: 受理中 7: 已预约 10: 已完成 15: 已终止
service_info 服务信息
sms_content 短信内容 String 给用户的包含挂号信息等服务信息的短信内容,服务类型为专家预约挂号时必传
set_call_time 通话时间 String 服务类型为专家电话时必传
status_msg 通话状态 String 服务类型为专家电话时必传
call_result 通话结果 String 服务类型为专家电话时必传
price_fen 医生服务价格 Int
refund_price_fen 退款价格 Int
stop_reason 终止原因 String 任务状态为已终止时必传

返回:

名称 说明 类型 必要 备注
error_code 错误码 int 正常返回0
error_msg 错误信息 string