H5交互示意圖

h5 接入流程

h5 聯調測試流程

1、申請測試 partner和partner_key，并參考基本注意事項。

2、構造 H5登錄入口 的URL，并加載對應頁面。

3、提供第三方接口用于接收醫生回復通知、問題關閉通知（可選）。

4、調用H5的問題查詢相關接口，進行問題查詢（可選）。

5、測試完畢后，聯系春雨人員開通正式環境賬戶后即可，第三方需要提供接收業務警報的郵箱地址。

h5 注意事項

1、H5入口頁面第三方客戶可以修改logo，但是需要保證春雨LOGO露出。第三方提供最終設計方案（JPG或PNG格式，尺寸 500*90）給春雨，由春雨相關人員配置上線。

2、用戶可以自定義LOGO下面的文字內容，需要將文本內容提供給春雨相關人員進行配置。

3、用戶可以更改H5頁面的主色調，將色調值(例如#129aee)提供給春雨相關人員進行配置。

標準H5

（標準H5首頁圖片）

春雨提供給每一個合作商一個特定partner_key值,partner_key為春雨的加密密鑰。合作商訪問h5服務的時候,提供自定義的user_id來標識每一個用戶。使用partner_key、時間戳以及user_id加密生成sign,完成h5服務的驗證。查看加密方式

正確的URL格式: /cooperation/wap/login/?user_id=A800130&atime=1467098815&partner=chunyu_test&sign=5afda19c5d65a7a7

URL: /cooperation/wap/login/

請求方式: GET

請求參數:

名稱 說明 類型 長度 必要 備注
user_id 用戶名 String 32 是 用戶唯一標識,合作方定義（可為字母、數字、下劃線或其組合）
partner 合作方標識 String 32 是 我要申請
sign 簽名 String 32 是 必須在服務器端生成 生成方法
atime 簽名時間戳 Long 64 是 當前UNIX TIMESTAMP簽名時間戳 (如:137322417)
entrance_type 入口類型 String 否 pay:表示付費h5入口
free:表示免費h5入口
free_ask:表示免費問題的創建頁面

返回: h5頁面

商務售賣版H5

（商務售賣版H5首頁圖片）

春雨提供給每一個合作商一個特定partner_key值,partner_key為春雨的加密密鑰。合作商訪問h5服務的時候,提供自定義的user_id來標識每一個用戶。使用partner_key、時間戳以及user_id加密生成sign,完成h5服務的驗證。查看加密方式

正確的URL格式: /cooperation/wap/business/login/?user_id=A800130&atime=1467098815&partner=chunyu_test&sign=5afda19c5d65a7a7

URL: /cooperation/wap/business/login/

請求方式: GET

請求參數:

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

返回: h5頁面

SaaS版H5

（SaaS版H5首頁圖片）

春雨提供給每一個合作商一個特定partner_key值,partner_key為春雨的加密密鑰。合作商訪問h5服務的時候,提供自定義的user_id來標識每一個用戶。使用partner_key、時間戳以及user_id加密生成sign,完成h5服務的驗證。查看加密方式

正確的URL格式: /open-platform/m-saas/home/?user_id=A800130&atime=1467098815&partner=chunyu_test&sign=5afda19c5d65a7a7

URL: /open-platform/m-saas/home

請求方式: GET

請求參數:

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

返回:

無，跳轉目標頁面

回調管理

1.服務關閉和服務退款兩個通知并不互斥，在特殊場景中（特殊情況：已交互的問題被舉報時）會先關閉服務；
2.各類服務都可調用該接口，如同時接入多種服務類型，傳不同的參數即可，根據status區分來自哪種服務類型。

URL: 即合作方登陸管理后臺在上圖位置填寫的關閉回調路徑

請求方式: POST

請求參數:

名稱 說明 類型 長度 必要 備注
problem_id 問題編號 是 api接入返回Int,web接入返回加密的string
user_id 用戶名 String 32 是 用戶唯一標識,合作方定義
content 醫生答復內容 String 是 數據結構,可以包含除 patient_meta 之外的三種類型。
sign 簽名 String 32 是 生成方法 將生成方法中user_id換成problem_id,其他不變
atime 簽名時間戳 Long 64 是 當前UNIX TIMESTAMP簽名時間戳 (如:137322417)
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 否 
{
            "error": 0, // 0 代表成功,其它 代表異常
            "error_msg": "" //錯誤信息
        }

服務關閉通知接口

URL: 合作方登錄管理后臺后在上圖位置填寫

請求方式: POST

請求參數:

名稱 說明 類型 長度 必要 備注
problem_id 問題編號 是 api接入返回Int,web接入返回加密的string
user_id 用戶名 String 32 是 用戶唯一標識,合作方定義
msg 消息內容 String 是
status 問題狀態 String 是

close 回答完畢后關閉

refund 問題退款
price 退款金額 Int 否 單位為分
sign 簽名 String 32 是 生成方法 將生成方法中user_id換成problem_id,其他不變
atime 簽名時間戳 Long 64 是 當前UNIX TIMESTAMP簽名時間戳 (如:137322417)
refund_type 退款類型 Int 否 返回值及其類型說明：
1代表：醫生拒絕
2代表：用戶取消
3代表：超時退款
4代表：客服退款
5代表：被舉報退款


返回:

名稱 說明 類型 長度 必要 備注
error 錯誤碼 Int 32 是 0 代表成功,其它 代表異常
error_msg 異常信息 String 否 
{
            "error": 0, // 0 代表成功,其它 代表異常
            "error_msg": "" //錯誤信息
        }