視頻問診

簡介

視頻問診服務是針對用戶提供的一種快捷的視頻形式接診的醫療服務。

用戶購買此視頻問診后，可進入視頻候診房間等待醫生接診；接診過程中如出現意外情況中斷視頻，可繼續重連；問診結束后，醫生將給出相應的總結建議。

服務細則

  • 接診醫生范圍

    視頻問診提供接診服務的醫生均為公立三甲醫院全科醫生

  • 服務時效及時長

    視頻問診提供7*24小時服務，單次視頻問診時長最長30分鐘

  • 服務意外中斷

    視頻問診意外中斷后，用戶可在原來的問診記錄中找到上次視頻問診記錄，重新進入繼續發起問診

  • 服務退款細則

    視頻問診購買后，醫生未接診前可自主取消；視頻問診購買后，1小時內沒有與醫生正常通話，問診自動退款

服務接入建議

  • 視頻問診提供三種方式的接入，分別為H5、小程序、SDK方式
  • 如通過H5和SDK方式接入視頻問診時，建議同步接通視頻問診相關回調，并在用戶側做相應的提醒，以提高視頻接通率
  • 視頻問診接入時，春雨側一般不處理用戶支付相關邏輯，支付及用戶權益等邏輯由合作方側完成，春雨側負責視頻連接
  • 視頻問診接入流程，春雨側提供兩種標準商務場景供合作方選擇，可根據實際場景接入服務，詳見下方商務場景“單次視頻問診”、“權益卡視頻問診”

服務流程示意圖

單次視頻問診

場景介紹

  • 單次視頻問診服務場景是：用戶通過合作方側訪問春雨視頻問診入口后，春雨側則認為該用戶是可以免費問診的，無需進行支付
  • 用戶支付的邏輯均在合作方側完成，合作方可自行根據自己的業務邏輯來定制，春雨側只負責免費連接視頻問診
  • 合作方與春雨側結算是按照實際完成的視頻問診訂單來扣減企業服務包使用數量
  • 如用戶上次視頻問診未完成，則從合作方視頻入口發起時，依然會繼續該用戶上一次未完成的視頻問診，繼續與醫生進行連接

接入流程

用戶信息同步接口

鑒權說明：在接口中標明用戶表示為「user_id/phone」的接口，表示該接口支持第三方用戶id、手機號參與鑒權，如使用手機號，生成簽名時將phone替換成user_id計算簽名。當傳遞用戶手機號時，會在春雨為該手機號自動創建用戶。 說明：合作方調用此接口，將用戶身份信息傳給春雨，春雨入庫成功后，可發起視頻問診

URL：/cooperation/server/video/inquiry/set_user_video_info/

請求方式：POST

請求參數:

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

返回:

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

跳轉視頻問診服務-H5

說明：調用此接口，春雨調起H5進行視頻問診。當用戶無正在進行的問診時，創建新問診并接入，當用戶有中斷未完成的問診時，自動重連。

【此接口非API接口，直接拼好參數下發給用戶側作為H5鏈接訪問即可】

URL：/cooperation/saas/jump_service_use_page/

請求方式：GET

請求參數:

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

返回:

直接跳轉服務頁面進行問診

視頻問診H5兼容性

說明：基于 WebRTC 實現，目前支持桌面端和移動端的主流瀏覽器，詳細支持度：參見鏈接

如需檢測Webview是否具備WebRTC能力，使用該鏈接在相應的webview訪問即可

您可以使用 rtc-detect 用來檢測當前環境對WebRTC的支持度，以及當前環境的詳細信息。(建議視頻問診前先使用下列代碼檢測,未通過檢測會出現黑屏現象,業務側酌情處理):

安裝

npm install rtc-detect

使用方法

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

跳轉視頻問診服務-小程序

說明：調用此接口，春雨調起小程序進行問診。當用戶無正在進行的問診時，創建新問診并接入，當用戶有中斷未完成的問診時，自動重連。

URL：/cooperation/saas/jump_wxapp/

請求方式：GET

請求參數:

名稱 說明 類型 必要 備注
user_id/phone 用戶標識 string 是
partner 合作方標識 string 是 我要申請
sign 簽名 string 是 必須在服務器端生成生成方法
atime 時間戳 long 是 當前UNIX TIMESTAMP簽名時間戳(如:137322417)
coop_service_type 業務場景 string 是 視頻問診場景值為 video_inquiry_saas
is_json 是否返回 json int 是 0 表示自動跳轉小程序，用于微信外跳轉（APP、H5）；
1 表示獲取小程序跳轉參數，用于第三方微信小程序內跳轉；

返回:

（is_json=0）

直接跳轉小程序頁面問診

（is_json=1）

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

備注：小程序內跳轉使用微信提供的跳轉方式，使用接口中返回的參數按下述規則拼參數

appid: wx214b7e2bcde837d6

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

測試環境需要確認跳轉時打開的是體驗版；并且在path后添加env參數，取值biz/test取決于再哪一個測試環境測試；例：pages/open_login/index?token={token}&session_id={session_id}&env=test

權益卡視頻問診

場景介紹

  • 權益卡視頻問診服務場景是：合作方提前定義好自己業務涉及到的權益卡類型，例如月卡31天無限次視頻問診，由春雨生成權益標識，供合作方使用
  • 合作方通過接口調用的方式將自己平臺的用戶設置對應的權益，例如黃金會員使用權益卡31天5次視頻問診，鉑金會員使用權益卡31天10次視頻問診等
  • 合作方側是否付費及付費流程在合作方側完成，設置用戶權益后，通過接口跳轉春雨的H5/小程序進行視頻問診，無需再次付費
  • 當用戶使用視頻問診服務后，春雨會通過接口實時告知合作方用戶當前剩余權益次數，合作方可自行進行展示
  • 合作方與春雨進行結算的方式有兩類，一類是按照實際完成的視頻問診訂單來扣減企業服務包使用數量，一類是按照成功同步用戶權益次數進行收費

接入流程

用戶同步權益接口

說明：接入方調用此接口，春雨為用戶增加策略對應服務權益，一個策略包含了若干服務類型和相應的可使用次數，以及有效期，在同步權益成功后立即生效。同一個用戶只可以有一個有效策略。

URL：/cooperation/server/saas/set_user_benefit_strategy/

請求方式：POST

請求參數:

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

返回:

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

用戶權益撤銷接口

說明：接入方調用此接口，將用戶生效中的權益立即停止。

URL：/cooperation/server/saas/revoke_user_benefit_strategy/

請求方式：POST

請求參數:

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

返回:

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

跳轉視頻問診服務-H5

說明：調用此接口，春雨調起H5的服務介紹頁后，可進行視頻問診。

【此接口非API接口，直接拼好參數下發給用戶側作為H5鏈接訪問即可】

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

請求方式：GET

請求參數:

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

返回:

直接跳轉服務介紹H5頁面

跳轉視頻問診服務-小程序

說明：當在第三方APP或小程序中跳轉春雨小程序時，使用【跳轉視頻服務-H5】接口中生成的鏈接作為參數，通過微信提供的方式進行跳轉。春雨側提供跳轉小程序的appid和頁面路徑

微信跳轉參數：

appid: wx214b7e2bcde837d6

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

查詢用戶權益接口

說明：調用此接口，返回用戶當前的權益情況

URL：/cooperation/server/saas/get_user_benefit_strategy/

請求方式：POST

請求參數:

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

返回:

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

usage_info 數據示例:

示例：三甲問診共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
                }
              }

權益使用回調

說明：當用戶使用權益，創建服務后，春雨調用此接口通知合作方

URL：復用回調管理-醫生回復通知接口URL，通過status判斷回調功能

請求方式：POST

請求參數:

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

返回:

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

視頻問診通用回調

視頻問診狀態變更回調

說明：當視頻問診狀態發生變更時，春雨調用此接口通知合作方。

URL：即合作方管理后臺-賬戶管理-信息配置中填寫的視頻問診狀態變更回調路徑

請求方式：POST

請求參數:

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

返回:

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

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

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