H5交互示意圖

h5 接入流程

h5 聯(lián)調(diào)測試流程

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

2、構(gòu)造 H5登錄入口 的URL，并加載對應(yīng)頁面。

3、提供第三方接口用于接收醫(yī)生回復(fù)通知、問題關(guān)閉通知（可選）。

4、調(diào)用H5的問題查詢相關(guān)接口，進(jìn)行問題查詢（可選）。

5、測試完畢后，聯(lián)系春雨人員開通正式環(huán)境賬戶后即可，第三方需要提供接收業(yè)務(wù)警報(bào)的郵箱地址。

h5 注意事項(xiàng)

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

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

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

標(biāo)準(zhǔn)H5

（標(biāo)準(zhǔn)H5首頁圖片）

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

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

URL: /cooperation/wap/login/

請求方式: GET

請求參數(shù):

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

返回: h5頁面

商務(wù)售賣版H5

（商務(wù)售賣版H5首頁圖片）

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

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

URL: /cooperation/wap/business/login/

請求方式: GET

請求參數(shù):

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

返回: h5頁面

SaaS版H5

（SaaS版H5首頁圖片）

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

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

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

請求方式: GET

請求參數(shù):

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

返回:

無，跳轉(zhuǎn)目標(biāo)頁面

回調(diào)管理

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

URL: 即合作方登陸管理后臺在上圖位置填寫的關(guān)閉回調(diào)路徑

請求方式: POST

請求參數(shù):

名稱 說明 類型 長度 必要 備注
problem_id 問題編號 是 api接入返回Int,web接入返回加密的string
user_id 用戶名 String 32 是 用戶唯一標(biāo)識,合作方定義
content 醫(yī)生答復(fù)內(nèi)容 String 是 數(shù)據(jù)結(jié)構(gòu),可以包含除 patient_meta 之外的三種類型。
sign 簽名 String 32 是 生成方法 將生成方法中user_id換成problem_id,其他不變
atime 簽名時間戳 Long 64 是 當(dāng)前UNIX TIMESTAMP簽名時間戳 (如:137322417)
doctor 醫(yī)生信息 dict 是 醫(yī)生信息
id 醫(yī)生 ID String 是
name 醫(yī)生姓名 String 200 是
image 醫(yī)生頭像 String 200 否 醫(yī)生照片的 url
title 醫(yī)生職稱 String
level_title 帶醫(yī)院級別的醫(yī)生職稱 String 帶醫(yī)院級別的醫(yī)生職稱
clinic 科室名稱 String 20 否
clinic_no 科室號 String 20 否
hospital 醫(yī)院名字 String 100 否
hospital_grade 醫(yī)院級別 String 是 醫(yī)院級別
good_at 擅長領(lǐng)域 String 是 擅長領(lǐng)域
education_background 教育背景 String 否

返回:

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

服務(wù)關(guān)閉通知接口

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

請求方式: POST

請求參數(shù):

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

close 回答完畢后關(guān)閉

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

返回:

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