視頻問(wèn)診

簡(jiǎn)介

視頻問(wèn)診服務(wù)是針對(duì)用戶提供的一種快捷的視頻形式接診的醫(yī)療服務(wù)。

用戶購(gòu)買此視頻問(wèn)診后,可進(jìn)入視頻候診房間等待醫(yī)生接診;接診過(guò)程中如出現(xiàn)意外情況中斷視頻,可繼續(xù)重連;問(wèn)診結(jié)束后,醫(yī)生將給出相應(yīng)的總結(jié)建議。

服務(wù)細(xì)則

  • 接診醫(yī)生范圍

    視頻問(wèn)診提供接診服務(wù)的醫(yī)生均為公立三甲醫(yī)院全科醫(yī)生

  • 服務(wù)時(shí)效及時(shí)長(zhǎng)

    視頻問(wèn)診提供7*24小時(shí)服務(wù),單次視頻問(wèn)診時(shí)長(zhǎng)最長(zhǎng)30分鐘

  • 服務(wù)意外中斷

    視頻問(wèn)診意外中斷后,用戶可在原來(lái)的問(wèn)診記錄中找到上次視頻問(wèn)診記錄,重新進(jìn)入繼續(xù)發(fā)起問(wèn)診

  • 服務(wù)退款細(xì)則

    視頻問(wèn)診購(gòu)買后,醫(yī)生未接診前可自主取消;視頻問(wèn)診購(gòu)買后,1小時(shí)內(nèi)沒(méi)有與醫(yī)生正常通話,問(wèn)診自動(dòng)退款

服務(wù)接入建議

  • 視頻問(wèn)診提供三種方式的接入,分別為H5、小程序、SDK方式
  • 如通過(guò)H5和SDK方式接入視頻問(wèn)診時(shí),建議同步接通視頻問(wèn)診相關(guān)回調(diào),并在用戶側(cè)做相應(yīng)的提醒,以提高視頻接通率
  • 視頻問(wèn)診接入時(shí),春雨側(cè)一般不處理用戶支付相關(guān)邏輯,支付及用戶權(quán)益等邏輯由合作方側(cè)完成,春雨側(cè)負(fù)責(zé)視頻連接
  • 視頻問(wèn)診接入流程,春雨側(cè)提供兩種標(biāo)準(zhǔn)商務(wù)場(chǎng)景供合作方選擇,可根據(jù)實(shí)際場(chǎng)景接入服務(wù),詳見(jiàn)下方商務(wù)場(chǎng)景“單次視頻問(wèn)診”、“權(quán)益卡視頻問(wèn)診”

服務(wù)流程示意圖

單次視頻問(wèn)診

場(chǎng)景介紹

  • 單次視頻問(wèn)診服務(wù)場(chǎng)景是:用戶通過(guò)合作方側(cè)訪問(wèn)春雨視頻問(wèn)診入口后,春雨側(cè)則認(rèn)為該用戶是可以免費(fèi)問(wèn)診的,無(wú)需進(jìn)行支付
  • 用戶支付的邏輯均在合作方側(cè)完成,合作方可自行根據(jù)自己的業(yè)務(wù)邏輯來(lái)定制,春雨側(cè)只負(fù)責(zé)免費(fèi)連接視頻問(wèn)診
  • 合作方與春雨側(cè)結(jié)算是按照實(shí)際完成的視頻問(wèn)診訂單來(lái)扣減企業(yè)服務(wù)包使用數(shù)量
  • 如用戶上次視頻問(wèn)診未完成,則從合作方視頻入口發(fā)起時(shí),依然會(huì)繼續(xù)該用戶上一次未完成的視頻問(wèn)診,繼續(xù)與醫(yī)生進(jìn)行連接

接入流程

用戶信息同步接口

鑒權(quán)說(shuō)明:在接口中標(biāo)明用戶表示為「user_id/phone」的接口,表示該接口支持第三方用戶id、手機(jī)號(hào)參與鑒權(quán),如使用手機(jī)號(hào),生成簽名時(shí)將phone替換成user_id計(jì)算簽名。當(dāng)傳遞用戶手機(jī)號(hào)時(shí),會(huì)在春雨為該手機(jī)號(hào)自動(dòng)創(chuàng)建用戶。 說(shuō)明:合作方調(diào)用此接口,將用戶身份信息傳給春雨,春雨入庫(kù)成功后,可發(fā)起視頻問(wèn)診

URL:/cooperation/server/video/inquiry/set_user_video_info/

請(qǐng)求方式:POST

請(qǐng)求參數(shù):

名稱 說(shuō)明 類型 必要 備注
user_id/phone 用戶標(biāo)識(shí) string
partner 合作方標(biāo)識(shí) string 我要申請(qǐng)
sign 簽名 string 必須在服務(wù)器端生成生成方法
atime 時(shí)間戳 long 當(dāng)前UNIX TIMESTAMP簽名時(shí)間戳(如:137322417)
patient_name 用戶姓名 string 張三
sex 性別 string
birthday 出生日期 string YYYY-MM-DD
identity_card 身份證號(hào) string

返回:

名稱 說(shuō)明 類型 必要 備注
error_code 錯(cuò)誤碼 int 正常返回0
error_msg 錯(cuò)誤信息 string

跳轉(zhuǎn)視頻問(wèn)診服務(wù)-H5

說(shuō)明:調(diào)用此接口,春雨調(diào)起H5進(jìn)行視頻問(wèn)診。當(dāng)用戶無(wú)正在進(jìn)行的問(wèn)診時(shí),創(chuàng)建新問(wèn)診并接入,當(dāng)用戶有中斷未完成的問(wèn)診時(shí),自動(dòng)重連。

【此接口非API接口,直接拼好參數(shù)下發(fā)給用戶側(cè)作為H5鏈接訪問(wèn)即可】

URL:/cooperation/saas/jump_service_use_page/

請(qǐng)求方式:GET

請(qǐng)求參數(shù):

名稱 說(shuō)明 類型 必要 備注
user_id/phone 用戶標(biāo)識(shí) string
partner 合作方標(biāo)識(shí) string 我要申請(qǐng)
sign 簽名 string 必須在服務(wù)器端生成生成方法
atime 時(shí)間戳 long 當(dāng)前UNIX TIMESTAMP簽名時(shí)間戳(如:137322417)
coop_service_type 業(yè)務(wù)場(chǎng)景 string 視頻問(wèn)診場(chǎng)景值為 video_inquiry_saas

返回:

直接跳轉(zhuǎn)服務(wù)頁(yè)面進(jìn)行問(wèn)診

視頻問(wèn)診H5兼容性

說(shuō)明:基于 WebRTC 實(shí)現(xiàn),目前支持桌面端和移動(dòng)端的主流瀏覽器,詳細(xì)支持度:參見(jiàn)鏈接

如需檢測(cè)Webview是否具備WebRTC能力,使用該鏈接在相應(yīng)的webview訪問(wèn)即可

您可以使用 rtc-detect 用來(lái)檢測(cè)當(dāng)前環(huán)境對(duì)WebRTC的支持度,以及當(dāng)前環(huán)境的詳細(xì)信息。(建議視頻問(wèn)診前先使用下列代碼檢測(cè),未通過(guò)檢測(cè)會(huì)出現(xiàn)黑屏現(xiàn)象,業(yè)務(wù)側(cè)酌情處理):

安裝

npm install rtc-detect

使用方法

          
          import RTCDetect from 'rtc-detect';
          // 初始化監(jiān)測(cè)模塊
          const detect = new RTCDetect();
          // 獲得當(dāng)前環(huán)境監(jiān)測(cè)結(jié)果
          const result = await detect.getCodecAsync();
          // result 包含了當(dāng)前環(huán)境編解碼支持度
          console.log('result is: ' + result);
          const {isH264EncodeSupported, isH264DecodeSupported} = result;
          if (isH264EncodeSupported && isH264DecodeSupported){
            // 通過(guò)檢測(cè)
          } else {
            // 未通過(guò)檢測(cè)
          }
          
          

跳轉(zhuǎn)視頻問(wèn)診服務(wù)-小程序

說(shuō)明:調(diào)用此接口,春雨調(diào)起小程序進(jìn)行問(wèn)診。當(dāng)用戶無(wú)正在進(jìn)行的問(wèn)診時(shí),創(chuàng)建新問(wèn)診并接入,當(dāng)用戶有中斷未完成的問(wèn)診時(shí),自動(dòng)重連。

URL:/cooperation/saas/jump_wxapp/

請(qǐng)求方式:GET

請(qǐng)求參數(shù):

名稱 說(shuō)明 類型 必要 備注
user_id/phone 用戶標(biāo)識(shí) string
partner 合作方標(biāo)識(shí) string 我要申請(qǐng)
sign 簽名 string 必須在服務(wù)器端生成生成方法
atime 時(shí)間戳 long 當(dāng)前UNIX TIMESTAMP簽名時(shí)間戳(如:137322417)
coop_service_type 業(yè)務(wù)場(chǎng)景 string 視頻問(wèn)診場(chǎng)景值為 video_inquiry_saas
is_json 是否返回 json int 0 表示自動(dòng)跳轉(zhuǎn)小程序,用于微信外跳轉(zhuǎn)(APP、H5);
1 表示獲取小程序跳轉(zhuǎn)參數(shù),用于第三方微信小程序內(nèi)跳轉(zhuǎn);

返回:

(is_json=0)

直接跳轉(zhuǎn)小程序頁(yè)面問(wèn)診

(is_json=1)

名稱 說(shuō)明 類型 必要 備注
error_code 錯(cuò)誤碼 int 正常返回0
error_msg 錯(cuò)誤信息 string
token string
session_id string

備注:小程序內(nèi)跳轉(zhuǎn)使用微信提供的跳轉(zhuǎn)方式,使用接口中返回的參數(shù)按下述規(guī)則拼參數(shù)

appid: wx214b7e2bcde837d6

path: pages/open_login/index?token={token}&session_id={session_id}

測(cè)試環(huán)境需要確認(rèn)跳轉(zhuǎn)時(shí)打開的是體驗(yàn)版;并且在path后添加env參數(shù),取值biz/test取決于再哪一個(gè)測(cè)試環(huán)境測(cè)試;例:pages/open_login/index?token={token}&session_id={session_id}&env=test

權(quán)益卡視頻問(wèn)診

場(chǎng)景介紹

  • 權(quán)益卡視頻問(wèn)診服務(wù)場(chǎng)景是:合作方提前定義好自己業(yè)務(wù)涉及到的權(quán)益卡類型,例如月卡31天無(wú)限次視頻問(wèn)診,由春雨生成權(quán)益標(biāo)識(shí),供合作方使用
  • 合作方通過(guò)接口調(diào)用的方式將自己平臺(tái)的用戶設(shè)置對(duì)應(yīng)的權(quán)益,例如黃金會(huì)員使用權(quán)益卡31天5次視頻問(wèn)診,鉑金會(huì)員使用權(quán)益卡31天10次視頻問(wèn)診等
  • 合作方側(cè)是否付費(fèi)及付費(fèi)流程在合作方側(cè)完成,設(shè)置用戶權(quán)益后,通過(guò)接口跳轉(zhuǎn)春雨的H5/小程序進(jìn)行視頻問(wèn)診,無(wú)需再次付費(fèi)
  • 當(dāng)用戶使用視頻問(wèn)診服務(wù)后,春雨會(huì)通過(guò)接口實(shí)時(shí)告知合作方用戶當(dāng)前剩余權(quán)益次數(shù),合作方可自行進(jìn)行展示
  • 合作方與春雨進(jìn)行結(jié)算的方式有兩類,一類是按照實(shí)際完成的視頻問(wèn)診訂單來(lái)扣減企業(yè)服務(wù)包使用數(shù)量,一類是按照成功同步用戶權(quán)益次數(shù)進(jìn)行收費(fèi)

接入流程

用戶同步權(quán)益接口

說(shuō)明:接入方調(diào)用此接口,春雨為用戶增加策略對(duì)應(yīng)服務(wù)權(quán)益,一個(gè)策略包含了若干服務(wù)類型和相應(yīng)的可使用次數(shù),以及有效期,在同步權(quán)益成功后立即生效。同一個(gè)用戶只可以有一個(gè)有效策略。

URL:/cooperation/server/saas/set_user_benefit_strategy/

請(qǐng)求方式:POST

請(qǐng)求參數(shù):

名稱 說(shuō)明 類型 必要 備注
user_id/phone 用戶ID string
partner 合作方標(biāo)識(shí) string 我要申請(qǐng)
sign 簽名 string 必須在服務(wù)器端生成生成方法
atime 時(shí)間戳 long 當(dāng)前UNIX TIMESTAMP簽名時(shí)間戳(如:137322417)
strategy_key 策略標(biāo)識(shí) string 線下提供
name 用戶姓名 string

返回:

名稱 說(shuō)明 類型 必要 備注
error_code 錯(cuò)誤碼 int 正常返回0
error_msg 錯(cuò)誤信息 string

用戶權(quán)益撤銷接口

說(shuō)明:接入方調(diào)用此接口,將用戶生效中的權(quán)益立即停止。

URL:/cooperation/server/saas/revoke_user_benefit_strategy/

請(qǐng)求方式:POST

請(qǐng)求參數(shù):

名稱 說(shuō)明 類型 必要 備注
user_id/phone 用戶ID string
partner 合作方標(biāo)識(shí) string 我要申請(qǐng)
sign 簽名 string 必須在服務(wù)器端生成生成方法
atime 時(shí)間戳 long 當(dāng)前UNIX TIMESTAMP簽名時(shí)間戳(如:137322417)

返回:

名稱 說(shuō)明 類型 必要 備注
error_code 錯(cuò)誤碼 int 正常返回0
error_msg 錯(cuò)誤信息 string

跳轉(zhuǎn)視頻問(wèn)診服務(wù)-H5

說(shuō)明:調(diào)用此接口,春雨調(diào)起H5的服務(wù)介紹頁(yè)后,可進(jìn)行視頻問(wèn)診。

【此接口非API接口,直接拼好參數(shù)下發(fā)給用戶側(cè)作為H5鏈接訪問(wèn)即可】

URL:/open-platform/m-saas/benefit-description/

請(qǐng)求方式:GET

請(qǐng)求參數(shù):

名稱 說(shuō)明 類型 必要 備注
user_id/phone 用戶標(biāo)識(shí) string
partner 合作方標(biāo)識(shí) string 我要申請(qǐng)
sign 簽名 string 必須在服務(wù)器端生成生成方法
atime 時(shí)間戳 long 當(dāng)前UNIX TIMESTAMP簽名時(shí)間戳(如:137322417)
coop_service_type 業(yè)務(wù)場(chǎng)景 string 視頻問(wèn)診場(chǎng)景值為 video_inquiry_saas

返回:

直接跳轉(zhuǎn)服務(wù)介紹H5頁(yè)面

跳轉(zhuǎn)視頻問(wèn)診服務(wù)-小程序

說(shuō)明:當(dāng)在第三方APP或小程序中跳轉(zhuǎn)春雨小程序時(shí),使用【跳轉(zhuǎn)視頻服務(wù)-H5】接口中生成的鏈接作為參數(shù),通過(guò)微信提供的方式進(jìn)行跳轉(zhuǎn)。春雨側(cè)提供跳轉(zhuǎn)小程序的appid和頁(yè)面路徑

微信跳轉(zhuǎn)參數(shù):

appid: wx214b7e2bcde837d6

path=pages/index/index?url= encodeURIComponent(H5_url)

查詢用戶權(quán)益接口

說(shuō)明:調(diào)用此接口,返回用戶當(dāng)前的權(quán)益情況

URL:/cooperation/server/saas/get_user_benefit_strategy/

請(qǐng)求方式:POST

請(qǐng)求參數(shù):

名稱 說(shuō)明 類型 必要 備注
user_id/phone 用戶ID string 用戶唯一標(biāo)識(shí),合作方定義(可為字母、數(shù)字、下劃線或其組合)
partner 合作方標(biāo)識(shí) string 我要申請(qǐng)
sign 簽名 string 必須在服務(wù)器端生成生成方法
atime 時(shí)間戳 long 當(dāng)前UNIX TIMESTAMP簽名時(shí)間戳(如:137322417)

返回:

名稱 說(shuō)明 類型 必要 備注
error_code 錯(cuò)誤碼 int 正常返回0
error_msg 錯(cuò)誤信息 string
strategy_key 策略id string 返回綁定的策略標(biāo)識(shí),若用戶沒(méi)有綁定的策略,則返回空字符串
usage_info 使用情況 dict 無(wú)綁定策略時(shí)返回空字典
key:coop_service_type
value:usage_item
total_count 可用次數(shù) int 當(dāng) is_unlimited=False 時(shí)必傳
is_unlimited 是否是無(wú)限次 bool 默認(rèn) False
used_count 已使用次數(shù) int

usage_info 數(shù)據(jù)示例:

示例:三甲問(wèn)診共3次,使用1次;三甲快捷電話共3次,使用0次

            
              {
                  "qc_hospital_upgrade": {
                  "total_count": 3,
                  "is_unlimited": False,
                  "used_count": 1
                },
                "fast_phone_3a": {
                  "total_count": 3,
                  "is_unlimited": False,
                  "used_count": 0
                }
              }
            
          

權(quán)益使用回調(diào)

說(shuō)明:當(dāng)用戶使用權(quán)益,創(chuàng)建服務(wù)后,春雨調(diào)用此接口通知合作方

URL:復(fù)用回調(diào)管理-醫(yī)生回復(fù)通知接口URL,通過(guò)status判斷回調(diào)功能

請(qǐng)求方式:POST

請(qǐng)求參數(shù):

名稱 說(shuō)明 類型 必要 備注
user_id/phone 用戶ID string 與同步權(quán)益接口使用的用戶ID key值相同
partner 合作方標(biāo)識(shí) string 我要申請(qǐng)
sign 簽名 string 必須在服務(wù)器端生成生成方法
atime 時(shí)間戳 long 當(dāng)前UNIX TIMESTAMP簽名時(shí)間戳(如:137322417)
status 回調(diào)類型 string status值為saas_use
coop_service_type 服務(wù)類型 string
use_count 使用次數(shù) int

返回:

名稱 說(shuō)明 類型 必要 備注
error_code 錯(cuò)誤碼 int 正常返回0
error_msg 錯(cuò)誤信息 string

視頻問(wèn)診通用回調(diào)

視頻問(wèn)診狀態(tài)變更回調(diào)

說(shuō)明:當(dāng)視頻問(wèn)診狀態(tài)發(fā)生變更時(shí),春雨調(diào)用此接口通知合作方。

URL:即合作方管理后臺(tái)-賬戶管理-信息配置中填寫的視頻問(wèn)診狀態(tài)變更回調(diào)路徑

請(qǐng)求方式:POST

請(qǐng)求參數(shù):

名稱 說(shuō)明 類型 必要 備注
atime 時(shí)間戳 long
sign 簽名 string 參考文檔,使用service_id參與計(jì)算
service_id 服務(wù)id int
user_id/phone 用戶標(biāo)識(shí) string
doctor_id 醫(yī)生id string
clinic_name 科室名稱 string
doctor_name 醫(yī)生姓名 string
doctor_avatar 醫(yī)生頭像 string
event_type 事件類型 string
start_time 問(wèn)診開始時(shí)間 string 問(wèn)診開始時(shí)傳 YYYY-MM-DD HH:MM:SS
end_time 問(wèn)診結(jié)束時(shí)間 string 問(wèn)診結(jié)束時(shí)傳 YYYY-MM-DD HH:MM:SS
user_info 用戶信息 dict
name 姓名 string
sex 性別 string m:男 f:女 b:未知
age 年齡 Int 顯示xx歲
summary_info 總結(jié)信息 dict 醫(yī)生發(fā)送總結(jié)時(shí)傳
possible_disease 可能疾病 string
suggestion 處理意見(jiàn) string
suggestion_detail 詳細(xì)意見(jiàn) string
playback_url 回放鏈接 str 回放鏈接生成時(shí)傳;
非永久鏈接,請(qǐng)及時(shí)轉(zhuǎn)存
chat_msg 聊天消息 dict 用戶或醫(yī)生發(fā)送聊天消息時(shí)時(shí)傳
is_doctor 是否是醫(yī)生發(fā)送 bool
content 消息內(nèi)容 string 數(shù)據(jù)結(jié)構(gòu)

返回:

名稱 說(shuō)明 類型 必要 備注
error_code 錯(cuò)誤碼 int 正常返回0
error_msg 錯(cuò)誤信息 string

視頻問(wèn)診事件類型event_type取值如下:

取值 說(shuō)明
user_enter 用戶進(jìn)入
doctor_enter 醫(yī)生進(jìn)入
start 問(wèn)診開始
user_interrupt 用戶退出中斷
doctor_interrupt 醫(yī)生退出中斷
finish 問(wèn)診結(jié)束
send_summary 醫(yī)生發(fā)送總結(jié)
refund 問(wèn)診退款
playback_create 回放鏈接生成
send_chat_msg 發(fā)送聊天消息