H5交互示意圖

h5 接入流程

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

1益缎、申請(qǐng)測(cè)試 partner和partner_key遇伞，并參考基本注意事項(xiàng)掂名。

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

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

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

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

h5 注意事項(xiàng)

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

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

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

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

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

春雨提供給每一個(gè)合作商一個(gè)特定partner_key值,partner_key為春雨的加密密鑰。合作商訪問h5服務(wù)的時(shí)候,提供自定義的user_id來標(biāo)識(shí)每一個(gè)用戶蔓钟。使用partner_key永票、時(shí)間戳以及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/

請(qǐng)求方式: GET

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

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

返回: h5頁(yè)面

商務(wù)售賣版H5

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

春雨提供給每一個(gè)合作商一個(gè)特定partner_key值,partner_key為春雨的加密密鑰。合作商訪問h5服務(wù)的時(shí)候,提供自定義的user_id來標(biāo)識(shí)每一個(gè)用戶兰绣。使用partner_key世分、時(shí)間戳以及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/

請(qǐng)求方式: GET

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

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

返回: h5頁(yè)面

SaaS版H5

（SaaS版H5首頁(yè)圖片）

春雨提供給每一個(gè)合作商一個(gè)特定partner_key值,partner_key為春雨的加密密鑰。合作商訪問h5服務(wù)的時(shí)候,提供自定義的user_id來標(biāo)識(shí)每一個(gè)用戶臀玄。使用partner_key瓢阴、時(shí)間戳以及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

請(qǐng)求方式: GET

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

名稱 說明 類型 必要 備注
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)
strategy_key 策略標(biāo)識(shí) string 否 線下提供

返回:

無(wú)盹躬，跳轉(zhuǎn)目標(biāo)頁(yè)面

回調(diào)管理

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

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

請(qǐng)求方式: POST

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

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

返回:

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

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

URL: 合作方登錄管理后臺(tái)后在上圖位置填寫

請(qǐng)求方式: POST

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

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

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

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

返回:

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