賬號同步/注冊接口

  • 賬號不存在 春雨會為該用戶創建一個新賬號,并登陸
  • 賬號已存在 春雨為當前用戶執行登錄操作,不必每次請求,新用戶只要同步過一次即可

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

常見錯誤碼

錯誤碼 錯誤信息 說明
1 default error 未歸類的請求或者處理錯誤
10001 invalid partner 第三方賬戶檢查失敗,請確保partner參數正確
10002 invalid user 第三方賬戶用戶id錯誤
10003 invalid username or password 第三方用戶驗證失敗,請確保同一用戶每次登錄的賬戶名和密碼一致
10004 invalid param content 問題內容檢查失敗,請確保問題格式符合要求
10005 invalid doctor id 醫生id無效
10006 sign verification failed 簽名驗證失敗,可以通過復現用例簽名來檢查構造sign方法是否正確
10007 atime time out 時間戳檢查失敗,請確保服務器時間已同步標準時間
10008 Missing param package_name or package_sign package_name或package_sign缺失
10009 Invalid mode(should be either server or client) 無效模式(應該為"client"或者"server")
10010 invalid problem_id 請求參數中的問題id不正確
10011 invalid start_num and count 無效的start_num或者count,必須是數字
10012 invalid ask text ask參數不存在
10013 invalid clinic no 科室號無效
10014 問題ID錯誤 該id對應的問題不存在
10015 非提問者不能執行該操作
10016 用戶不存在,請先注冊 收到此提示的原因是:該用戶尚未在春雨平臺注冊,針對此問題,合作方需使用登錄/注冊接口為該用戶(user_id)創建賬號并登錄
10017 param content is too long 問題或者評價內容超過5kB,極有可能是內容類型錯誤引起
10018 invalid atime atime 錯誤
10020 param "xx" check err 參數校驗錯誤
10101 content 類型需要為 text,image,audio,patient_meta 中任意一種
10102 缺少 text 字段內容
10103 缺少 file 字段內容
10104 缺少 age 和 sex 字段內容
10201 對不起,您不能提交問題。
10202 不能提問非醫療問題
10203 您已提問成功,無需重復提問
10301 問題已經被關閉/刪除,不能追問
10401 invalid star
10402 您已經進行過評價,不能再次評價! 收到此提示的原因是:已對該問題做過評價
10403 您現在還不能對該問題進行評價! 評價接口調用規則:問題交互3次以后可以評價,低于3次需等問題關閉后才可評價
10404 問題無醫生認領回答,不能評價 評價接口調用規則:問題交互3次以后可以評價,低于3次需等問題關閉后才可評價
10501 close problem failed 問題關閉錯誤,問題只能在有醫生領取并回答的情況下才能執行關閉操作。
10601 非問題創建者不能退款
10602 問題已經被醫生回復,不可以執行退款操作
10603 當前問題狀態不能進行該操作
10604 正式環境轉診問題不可以退款
10605 退款金額不能為0,請校驗退款金額
10606 無相應支付記錄
11001 invalid price 無效價格
11002 invalid partner_order_id 無效的partner訂單id
11003 duplicate partner_order_id 重復的partner訂單id
11004 invalid chunyu_order_id 無效的chunyu_order_id
11005 order does not exist 訂單不存在
11006 closed record 已關閉的記錄
11007 create payment order failed 創建支付訂單失敗
11008 not the order's owner 不是訂單創建者
11009 paid is not equal to price 支付金額與價格不相符
11012 invalid logistics_info format 無效的物流信息格式
11013 購買失敗
11014 您已被加入黑名單, 不能購買任何服務
12001 醫生不存在
12002 醫生未回答的問題數過多
12003 因違背提問規則,此功能暫不可用。如有疑問請聯系春雨在線客服 收到此提示的原因是:提問用戶已被加入黑名單,無法發起提問。黑名單相關邏輯,請參考“黑名單邏輯”章節。
12004 首問字數過少 圖文咨詢首問字數不得少于10個字
13001 醫生24小時內無法預約
14001 訂單創建失敗