視頻問診

簡介

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

用戶購買此視頻問診后潭千,可進入視頻候診房間等待醫(yī)生接診躏率;接診過程中如出現(xiàn)意外情況中斷視頻怀泊,可繼續(xù)重連茫藏;問診結(jié)束后误趴,醫(yī)生將給出相應(yīng)的總結(jié)建議。

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

  • 接診醫(yī)生范圍

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

  • 服務(wù)時效及時長

    視頻問診提供7*24小時服務(wù)刷允,單次視頻問診時長最長30分鐘

  • 服務(wù)意外中斷

    視頻問診意外中斷后冤留,用戶可在原來的問診記錄中找到上次視頻問診記錄,重新進入繼續(xù)發(fā)起問診

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

    視頻問診購買后树灶,醫(yī)生未接診前可自主取消纤怒;視頻問診購買后,1小時內(nèi)沒有與醫(yī)生正常通話天通,問診自動退款

服務(wù)接入建議

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

服務(wù)流程示意圖

單次視頻問診

場景介紹

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

接入流程

用戶信息同步接口

鑒權(quán)說明:在接口中標(biāo)明用戶表示為「user_id/phone」的接口减叫,表示該接口支持第三方用戶id萤遥、手機號參與鑒權(quán),如使用手機號烫扼,生成簽名時將phone替換成user_id計算簽名曙求。當(dāng)傳遞用戶手機號時碍庵,會在春雨為該手機號自動創(chuàng)建用戶映企。 說明:合作方調(diào)用此接口,將用戶身份信息傳給春雨静浴,春雨入庫成功后堰氓,可發(fā)起視頻問診

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

請求方式:POST

請求參數(shù):

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

返回:

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

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

說明:調(diào)用此接口挤渐,春雨調(diào)起H5進行視頻問診。當(dāng)用戶無正在進行的問診時双絮,創(chuàng)建新問診并接入浴麻,當(dāng)用戶有中斷未完成的問診時,自動重連囤攀。

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

URL:/cooperation/saas/jump_service_use_page/

請求方式:GET

請求參數(shù):

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

返回:

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

視頻問診H5兼容性

說明:基于 WebRTC 實現(xiàn),目前支持桌面端和移動端的主流瀏覽器焚挠,詳細(xì)支持度:參見鏈接

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

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

安裝

npm install rtc-detect

使用方法

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

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

說明:調(diào)用此接口尤稍,春雨調(diào)起小程序進行問診。當(dāng)用戶無正在進行的問診時倡搞,創(chuàng)建新問診并接入弓匪,當(dāng)用戶有中斷未完成的問診時,自動重連哥峡。

URL:/cooperation/saas/jump_wxapp/

請求方式:GET

請求參數(shù):

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

返回:

(is_json=0)

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

(is_json=1)

名稱 說明 類型 必要 備注
error_code 錯誤碼 int 正常返回0
error_msg 錯誤信息 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}

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

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

場景介紹

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

接入流程

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

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

URL:/cooperation/server/saas/set_user_benefit_strategy/

請求方式:POST

請求參數(shù):

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

返回:

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

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

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

URL:/cooperation/server/saas/revoke_user_benefit_strategy/

請求方式:POST

請求參數(shù):

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

返回:

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

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

說明:調(diào)用此接口,春雨調(diào)起H5的服務(wù)介紹頁后帮色,可進行視頻問診捶益。

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

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

請求方式:GET

請求參數(shù):

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

返回:

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

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

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

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

appid: wx214b7e2bcde837d6

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

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

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

URL:/cooperation/server/saas/get_user_benefit_strategy/

請求方式:POST

請求參數(shù):

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

返回:

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

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

示例:三甲問診共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)

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

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

請求方式:POST

請求參數(shù):

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

返回:

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

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

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

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

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

請求方式:POST

請求參數(shù):

名稱 說明 類型 必要 備注
atime 時間戳 long
sign 簽名 string 參考文檔腊敲,使用service_id參與計算
service_id 服務(wù)id int
user_id/phone 用戶標(biāo)識 string
doctor_id 醫(yī)生id string
clinic_name 科室名稱 string
doctor_name 醫(yī)生姓名 string
doctor_avatar 醫(yī)生頭像 string
event_type 事件類型 string
start_time 問診開始時間 string 問診開始時傳 YYYY-MM-DD HH:MM:SS
end_time 問診結(jié)束時間 string 問診結(jié)束時傳 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é)時傳
possible_disease 可能疾病 string
suggestion 處理意見 string
suggestion_detail 詳細(xì)意見 string
playback_url 回放鏈接 str 回放鏈接生成時傳;
非永久鏈接维苔,請及時轉(zhuǎn)存
chat_msg 聊天消息 dict 用戶或醫(yī)生發(fā)送聊天消息時時傳
is_doctor 是否是醫(yī)生發(fā)送 bool
content 消息內(nèi)容 string 數(shù)據(jù)結(jié)構(gòu)

返回:

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

視頻問診事件類型event_type取值如下:

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