API交互示意圖

開發(fā)流程示意圖

第三方可根據(jù)春雨提供的api按照如下大致流程進(jìn)行開發(fā)


問(wèn)題狀態(tài)的流轉(zhuǎn)示意圖

賬號(hào)同步/注冊(cè)接口

  • 賬號(hào)不存在 春雨會(huì)為該用戶創(chuàng)建一個(gè)新賬號(hào),并登陸
  • 賬號(hào)已存在 春雨為當(dāng)前用戶執(zhí)行登錄操作,不必每次請(qǐng)求,新用戶只要同步過(guò)一次即可

URL: /cooperation/server/login

請(qǐng)求方式: POST

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

名稱 說(shuō)明 類型 長(zhǎng)度 必要 備注
user_id 用戶名 String 32 用戶唯一標(biāo)識(shí),合作方定義(可為字母、數(shù)字、下劃線或其組合)
password 密碼 String 32
lon 經(jīng)度 String 例如: 北京 lon = '116.3'
lat 緯度 String 例如: 北京 lat = '39.9'
partner 合作方標(biāo)識(shí) String 32 我要申請(qǐng)
sign 簽名 String 32 必須在服務(wù)器端生成 生成方法
atime 簽名時(shí)間戳 Long 64 當(dāng)前UNIX TIMESTAMP簽名時(shí)間戳 (如:137322417)

返回:

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

post數(shù)據(jù)示例

            
              {
                "partner": "test",
                "user_id": "test_user",
                "password": "12345678",
                "sign": "cb5a715fdbeb7220",
                "atime": "1608207278"
              }
            
          

響應(yīng)示例

            
              {
                "error": 0,
                "error_msg": "user logged in ok"
              }
            
          

普通眾包服務(wù)

簡(jiǎn)介

指用戶不篩選醫(yī)生資質(zhì)發(fā)起提問(wèn),由春雨通過(guò)智能分診匹配合適醫(yī)生;醫(yī)生可以選擇是否認(rèn)領(lǐng)問(wèn)題,若在24小時(shí)內(nèi)醫(yī)生未回復(fù),該問(wèn)題即會(huì)被系統(tǒng)關(guān)閉。

接入流程

1、申請(qǐng)測(cè)試partner和partner_key,并參考基本注意事項(xiàng)

2、提供第三方接口用于接收醫(yī)生回復(fù)通知問(wèn)題關(guān)閉通知。

3、同步第三方賬戶信息(即調(diào)用賬號(hào)同步/登陸接口),對(duì)于新用戶發(fā)起一次即可。

4、第三方創(chuàng)建眾包問(wèn)題(由系統(tǒng)分配科室,或由第三方自主選擇科室)。

5、通過(guò)管理后臺(tái)模擬醫(yī)生回復(fù)問(wèn)題, 第三方接口問(wèn)題的回復(fù)通知,或者根據(jù)需求由春雨人員配合回復(fù)醫(yī)生問(wèn)題。

6、第三方提交用戶追問(wèn)。

7、第三方發(fā)起問(wèn)題關(guān)閉,并接收問(wèn)題關(guān)閉通知。

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

9、完整的問(wèn)診流程需要結(jié)合通用接口來(lái)實(shí)現(xiàn)

創(chuàng)建眾包問(wèn)題接口

URL: /cooperation/server/free_problem/create

請(qǐng)求方式: POST

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

名稱 說(shuō)明 類型 長(zhǎng)度 必要 備注
user_id 用戶名 String 32 用戶唯一標(biāo)識(shí),合作方定義(可為字母、數(shù)字、下劃線或其組合)
partner 合作方標(biāo)識(shí) String 32 我要申請(qǐng)
content 為用戶提問(wèn)內(nèi)容列表 String 5120 數(shù)據(jù)結(jié)構(gòu),其中 patient_meta 不能傳遞多次,以第一次內(nèi)容的為準(zhǔn)。
sign 簽名 String 32 必須在服務(wù)器端生成 生成方法
atime 簽名時(shí)間戳 Long 64 當(dāng)前UNIX TIMESTAMP簽名時(shí)間戳 (如:137322417)
clinic_no 需要分配的科室號(hào) String 20 科室

返回:

名稱 說(shuō)明 類型 長(zhǎng)度 必要 備注
error 錯(cuò)誤碼 Int 32 0 代表成功,其它 代表異常
error_msg 異常信息 String
problem_id 問(wèn)題編號(hào) Int 32 當(dāng) error 為 0 時(shí)返回創(chuàng)建的問(wèn)題 ID

post數(shù)據(jù)示例

            
              {
                "user_id": "test_user",
                "partner": "test",
                "content": "[{\"type\": \"patient_meta\",\"age\": \"20歲\",\"sex\": \"男\(zhòng)"},{\"type\": \"text\",\"text\": \"創(chuàng)建免費(fèi)問(wèn)診問(wèn)題測(cè)試\"}]",
                "sign": "b26144805c3f88f4",
                "atime": "1608207611"
              }
            
          

響應(yīng)示例

            
              {
                "error": 0,
                "problem_id": 443258121
              }
            
          

眾包升級(jí)服務(wù)

簡(jiǎn)介

即春雨平臺(tái)會(huì)將用戶問(wèn)題智能分配給特定醫(yī)生等級(jí)或特定醫(yī)院等級(jí)的醫(yī)生;比起普通眾包服務(wù),眾包升級(jí)具備更優(yōu)質(zhì)的服務(wù)質(zhì)量。

當(dāng)用戶發(fā)起提問(wèn),春雨平臺(tái)首先對(duì)匹配的醫(yī)院或醫(yī)生等級(jí)進(jìn)行篩選,而后進(jìn)行智能分診,若在1小時(shí)內(nèi)沒(méi)有回復(fù),系統(tǒng)即自動(dòng)關(guān)閉該問(wèn)題。

接入流程

創(chuàng)建眾包升級(jí)問(wèn)題接口

URL: /cooperation/server/problem/create_paid_problem/

請(qǐng)求方式: POST

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

名稱 說(shuō)明 類型 長(zhǎng)度 必要 備注
user_id 用戶ID String 32 用戶唯一標(biāo)識(shí),合作方定義(可為字母、數(shù)字、下劃線或其組合)
partner 合作方標(biāo)識(shí) String 32 我要申請(qǐng)
content 問(wèn)題內(nèi)容 String 5120 數(shù)據(jù)結(jié)構(gòu),其中 patient_meta 不能傳遞多次,以第一次內(nèi)容的為準(zhǔn)。
sign 簽名 String 32 必須在服務(wù)器端生成 生成方法
atime 時(shí)間戳 Long 64 當(dāng)前UNIX TIMESTAMP簽名時(shí)間戳 (如:137322417)
partner_order_id 合作方支付ID String 32 唯一標(biāo)識(shí)本次支付行為
pay_type 付費(fèi)升級(jí)類型 String 32 二甲醫(yī)生:
qc_hospital_common
三甲醫(yī)生:
qc_hospital_upgrade
clinic_no 需要分配的科室號(hào) String 10 科室

返回:

名稱 說(shuō)明 類型 長(zhǎng)度 必要 備注
error 錯(cuò)誤碼 Int 0 代表成功,其它 代表異常
error_msg 異常信息 String
problem_id 問(wèn)題編號(hào) Int 64 當(dāng) error 為 0 時(shí)返回創(chuàng)建的問(wèn)題 ID

post數(shù)據(jù)示例

            
              {
                "user_id": "test_user",
                "partner": "test",
                "content": "[{\"type\": \"patient_meta\",\"age\": \"20歲\",\"sex\": \"男\(zhòng)"},{\"type\": \"text\",\"text\": \"創(chuàng)建眾包升級(jí)問(wèn)診問(wèn)題測(cè)試\"}]",
                "sign": "b26144805c3f88f4",
                "atime": "1608207611",
                "partner_order_id": "000001",
                "pay_type": "qc_hospital_upgrade"
              }
            
          

響應(yīng)示例

            
              {
                "error": 0,
                "error_msg": "",
                "problem_id": 443258122
              }
            
          

眾包升級(jí)問(wèn)題退款接口

退款條件:醫(yī)生未回答情況下才可調(diào)用該接口實(shí)現(xiàn)退款

URL: /cooperation/server/problem/refund

請(qǐng)求方式: POST

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

名稱 說(shuō)明 類型 長(zhǎng)度 必要 備注
user_id 用戶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)
problem_id 問(wèn)題ID Int 64

返回:

名稱 說(shuō)明 類型 長(zhǎng)度 必要 備注
error 錯(cuò)誤碼 Int 0 代表成功,其它 代表異常
error_msg 異常信息 String

post數(shù)據(jù)示例

            
              {
                "user_id": "test_user",
                "problem_id": "443258127",
                "partner": "test",
                "sign": "5a236b488f7eaacc",
                "atime": "1608208460"
              }
            
          

響應(yīng)示例

            
              {
                "error": 0,
                "error_msg": ""
              }
            
          

定向圖文服務(wù)

簡(jiǎn)介

指用戶付費(fèi)購(gòu)買指定醫(yī)生的圖文咨詢服務(wù)。

包括四種產(chǎn)品形態(tài):找醫(yī)生/名醫(yī)咨詢/推薦醫(yī)生/搜索醫(yī)生,具體請(qǐng)參見(jiàn)下方的接口說(shuō)明。

包含兩種服務(wù)標(biāo)準(zhǔn):普通定向咨詢和名醫(yī)咨詢,普通定向咨詢指用戶購(gòu)買指定醫(yī)生的圖文咨詢,醫(yī)生通過(guò)圖文形式耐心細(xì)致的解答用戶健康問(wèn)題,最多30次交互/醫(yī)生首次回復(fù)48H后問(wèn)題關(guān)閉;名醫(yī)咨詢是指由春雨平臺(tái)精選的各個(gè)??祁I(lǐng)域的大牌專家資源,用戶付費(fèi)購(gòu)買后,專家將以圖文形式提供明確、放心的診療建議;需要注意的是,名醫(yī)咨詢最多10次交互/醫(yī)生首次回復(fù)48H后問(wèn)題關(guān)閉。

接入流程

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

2、提供第三方接口用于接收醫(yī)生回復(fù)通知、問(wèn)題關(guān)閉通知

3、同步第三方賬戶信息,對(duì)于新用戶發(fā)起一次即可。

4、第三方查詢推薦醫(yī)生,獲取醫(yī)生列表。

5、第三方創(chuàng)建付費(fèi)問(wèn)診記錄,并引導(dǎo)用戶在第三方APP內(nèi)進(jìn)行付費(fèi)(付費(fèi)流程由第三方自己實(shí)現(xiàn))。

6、第三方發(fā)送付費(fèi)成功通知,春雨創(chuàng)建付費(fèi)問(wèn)題后返回相關(guān)問(wèn)題信息給第三方。

7、第三方調(diào)用相關(guān)接口進(jìn)行問(wèn)題交互,方法同眾包問(wèn)題交互一樣。

8、第三方接收問(wèn)題關(guān)閉通知,觸發(fā)方式:第三方主動(dòng)發(fā)起 或 春雨醫(yī)生拒絕問(wèn)題。

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

10、第三方開發(fā)定向問(wèn)診需用以下接口結(jié)合通用接口來(lái)完善整個(gè)流程。

找醫(yī)生接口

說(shuō)明:第三方根據(jù)一級(jí)科室編號(hào)查詢醫(yī)生,獲取醫(yī)生列表;該接口可借助篩選名醫(yī)來(lái)實(shí)現(xiàn)名醫(yī)咨詢服務(wù),若不篩選名醫(yī)將返回春雨普通醫(yī)生和名醫(yī)

URL: /cooperation/server/doctor/get_clinic_doctors

請(qǐng)求方式: POST

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

名稱 說(shuō)明 類型 長(zhǎng)度 必要 備注
partner 合作方標(biāo)識(shí) String 32 我要申請(qǐng)
sign 簽名 String 32 必須在服務(wù)器端生成 生成方法
user_id 用戶名 String 32 用戶唯一標(biāo)識(shí),合作方定義(可為字母、數(shù)字、下劃線或其組合)
atime 簽名時(shí)間戳 Long 64 當(dāng)前UNIX TIMESTAMP簽名時(shí)間戳 (如:137322417)
start_num 開始數(shù) Int 32 翻頁(yè)時(shí)的起始序列號(hào),舉例:比如從第40個(gè)醫(yī)生開始,就意味著獲取第40-60的醫(yī)生
count 每次取的醫(yī)生數(shù) Int 32 取值范圍1-20
clinic_no 科室編號(hào) String 一級(jí)科室;科室信息請(qǐng)查看科室劃分
second_class_clinic_no 二級(jí)科室編號(hào) String 二級(jí)科室;該字段有值時(shí)忽略一級(jí)科室字段
hospital_id 醫(yī)院id String
famous_doctor 是否篩選名醫(yī) Int 32 接受值:0:否,?1:是
query_text 查找參數(shù) String 100 搜索詞(癥狀,疾病,醫(yī)院,科室,醫(yī)生名)
province 省份 String 具體查看
city 城市 String 具體查看
title 職稱 String 職稱篩選,可選項(xiàng)[主任醫(yī)師, 副主任醫(yī)師, 主治醫(yī)師, 醫(yī)師, 心理咨詢師, 公共營(yíng)養(yǎng)師];可多選,使用'|'分隔
hospital_grade 醫(yī)院等級(jí) String 醫(yī)院等級(jí)篩選,可選項(xiàng)[三級(jí)甲等、三級(jí)乙等、三級(jí)丙等、三級(jí)其他、二級(jí)甲/乙/丙等、二級(jí)其他、二級(jí)未評(píng)、一級(jí)甲/乙/丙等、??芣;可多選,使用'|'分隔
min_price 最低圖文價(jià)格 Int 單位元;不傳則不限制最低價(jià)
max_price 最高圖文價(jià)格 Int 單位元;不傳則不限制最高價(jià)
service_score 最低服務(wù)指數(shù) Int
speed_score 最低速度指數(shù) Int
solution_score 最低專業(yè)指數(shù) Int
service_type 服務(wù)類型 String 不填為默認(rèn)獲取開通圖文服務(wù)的醫(yī)生;值為inquiry表示獲取開通普通電話服務(wù)的醫(yī)生,值為expert_call表示獲取開通專家電話服務(wù)的醫(yī)生,值為expert_register_apply表示獲取開通專家預(yù)約掛號(hào)服務(wù)的醫(yī)生;支持多選,多選時(shí)以|分隔
is_active 是否在線 Int 傳1時(shí)篩選在線醫(yī)生
is_top_100_hospital 是否百?gòu)?qiáng)醫(yī)院 Int 傳1時(shí)篩選百?gòu)?qiáng)醫(yī)院醫(yī)生

返回:

名稱 說(shuō)明 類型 長(zhǎng)度 必要 備注
doctors 醫(yī)生list array
clinic_name 科室名稱 String
second_clinic_name 二級(jí)科室名稱 String
hospital_grade 醫(yī)院等級(jí) String 如:三級(jí)甲等
good_at 擅長(zhǎng) String
hospital_name 醫(yī)院名稱 String
image 醫(yī)生頭像 String 200 醫(yī)生照片的 url
id 醫(yī)生id String
name 醫(yī)生姓名 String
price 價(jià)格 Int 單位為分,不需要緩存醫(yī)生價(jià)錢信息,該信息必須實(shí)時(shí)獲取
purchase_num 購(gòu)買數(shù)量 Int
title 職稱 string
is_famous_doctor 是否是名醫(yī)咨詢 bool 名醫(yī)咨詢10次交互/48h后問(wèn)題關(guān)閉;普通定向問(wèn)題30次交互/48h后問(wèn)題關(guān)閉
tel_online 是否可以預(yù)約電話問(wèn)診 bool 是否支持電話問(wèn)診下單
tel_price 電話問(wèn)診時(shí)長(zhǎng)對(duì)應(yīng)的價(jià)格 string json格式,key為時(shí)長(zhǎng),value為對(duì)應(yīng)的價(jià)格,單位分。-1為此時(shí)長(zhǎng)服務(wù)未開通
expert_call_price_fen 專家電話價(jià)格 Int 單位為分,-1為此服務(wù)未開通
expert_register_price_fen 專家預(yù)約掛號(hào)價(jià)格 Int 單位為分,-1為此服務(wù)未開通
is_active 是否在線 bool
is_top_100_hospital 是否百?gòu)?qiáng)醫(yī)院 bool
good_rate 好評(píng)率 string 最高100,如‘98.8’
error 錯(cuò)誤碼 Int 32 0 代表成功,其它 代表異常
error_msg 異常信息 String

post數(shù)據(jù)示例

    
      {
        "clinic_no": "1",
        "famous_doctor": "1",
        "user_id": "test_user",
        "start_num": "20",
        "count": "20",
        "partner": "test",
        "sign": "24c0b782f23e71f1",
        "atime": "1608209559"
      }
    
  

響應(yīng)示例

    
      {
        "error": 0,
        "doctors": [{
          "clinic_name": "兒科",
          "second_clinic_name": "小兒科",
          "good_at": "發(fā)育遲緩、頭痛、遺傳代謝病",
          "hospital_name": "北京第一醫(yī)院",
          "hospital_grade": "三級(jí)甲等",
          "id": "0000001",
          "image": "https://resource.chunyu.mobi/@/media/images/image1.jpg",
          "name": "測(cè)試醫(yī)生",
          "price": 100,
          "purchase_num": 771,
          "title": "主治醫(yī)師",
          "is_famous_doctor": false,
          "tel_online": false,
          "tel_price": "{\"10\": -1, \"15\": -1, \"20\": -1, \"30\": -1}"
        },
        {
          "clinic_name": "兒科",
          "second_clinic_name": "小兒科",
          "good_at": "多動(dòng)癥、小兒癲癇、抽動(dòng)癥",
          "hospital_name": "解放軍總醫(yī)院",
          "hospital_grade": "三級(jí)甲等",
          "id": "0000002",
          "image": "https://resource.chunyu.mobi/@/media/images/image2.jpg",
          "name": "測(cè)試醫(yī)生2",
          "price": 10000,
          "purchase_num": 1000,
          "title": "主任醫(yī)師",
          "is_famous_doctor": true,
          "tel_online": true,
          "tel_price": "{\"10\": 16000, \"15\": 24000, \"20\": 40000, \"30\": -1}"
        }]
      }
    
  

推薦醫(yī)生接口

說(shuō)明:用戶輸入提問(wèn)內(nèi)容后,春雨智能推薦一批擅長(zhǎng)解答用戶問(wèn)題的醫(yī)生列表;此服務(wù)可作為找醫(yī)生服務(wù)的補(bǔ)充,一方面避免用戶選錯(cuò)科室醫(yī)生問(wèn)診,另外推薦的醫(yī)生回復(fù)時(shí)效性較好

URL: /cooperation/server/doctor/get_recommended_doctors

請(qǐng)求方式: POST

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

名稱 說(shuō)明 類型 長(zhǎng)度 必要 備注
ask 首次提問(wèn)內(nèi)容文本 String 患者首問(wèn)字?jǐn)?shù)請(qǐng)限制在10-500字
partner 合作方標(biāo)識(shí) String 32 我要申請(qǐng)
sign 簽名 String 32 必須在服務(wù)器端生成 生成方法
user_id 用戶名 String 32 用戶唯一標(biāo)識(shí),合作方定義(可為字母、數(shù)字、下劃線或其組合)
atime 簽名時(shí)間戳 Long 64 當(dāng)前UNIX TIMESTAMP簽名時(shí)間戳 (如:137322417)

返回:

名稱 說(shuō)明 類型 長(zhǎng)度 必要 備注
doctors 醫(yī)生list array
clinic_name 科室名稱 String
second_clinic_name 二級(jí)科室名稱 String
hospital_grade 醫(yī)院等級(jí) String 如:三級(jí)甲等
good_at 擅長(zhǎng) String
hospital_name 醫(yī)院名稱 String
image 醫(yī)生頭像 String 200 醫(yī)生照片的 url
id 醫(yī)生id String
name 醫(yī)生姓名 String
price 價(jià)格 Int 單位為分,不需要緩存醫(yī)生價(jià)錢信息,該信息必須實(shí)時(shí)獲取
purchase_num 購(gòu)買數(shù)量 Int
title 職稱 string
is_famous_doctor 是否是名醫(yī)咨詢 bool 名醫(yī)咨詢10次交互/48h后問(wèn)題關(guān)閉;普通定向問(wèn)題30次交互/48h后問(wèn)題關(guān)閉
tel_online 是否可以預(yù)約電話問(wèn)診 bool 是否支持電話問(wèn)診下單
tel_price 電話問(wèn)診時(shí)長(zhǎng)對(duì)應(yīng)的價(jià)格 string json格式,key為時(shí)長(zhǎng),value為對(duì)應(yīng)的價(jià)格,單位分。-1為此時(shí)長(zhǎng)服務(wù)未開通
error 錯(cuò)誤碼 Int 32 0 代表成功,其它 代表異常
error_msg 異常信息 String

post數(shù)據(jù)示例

    
      {
        "ask": "孩子發(fā)燒總不好",
        "user_id": "test_user",
        "partner": "test",
        "sign": "c30cd1025b2e7912",
        "atime": "1608260984"
      }
    
  

響應(yīng)示例

    
      {
        "error": 0,
        "doctors": [{
          "clinic_name": "兒科",
          "second_clinic_name": "小兒科",
          "good_at": "發(fā)育遲緩、頭痛、遺傳代謝病",
          "hospital_name": "北京第一醫(yī)院",
          "hospital_grade": "三級(jí)甲等",
          "id": "0000001",
          "image": "https://resource.chunyu.mobi/@/media/images/image1.jpg",
          "name": "測(cè)試醫(yī)生",
          "price": 100,
          "purchase_num": 771,
          "title": "主治醫(yī)師",
          "is_famous_doctor": false,
          "tel_online": false,
          "tel_price": "{\"10\": -1, \"15\": -1, \"20\": -1, \"30\": -1}"
        },
        {
          "clinic_name": "兒科",
          "second_clinic_name": "小兒科",
          "good_at": "多動(dòng)癥、小兒癲癇、抽動(dòng)癥",
          "hospital_name": "解放軍總醫(yī)院",
          "hospital_grade": "三級(jí)甲等",
          "id": "0000002",
          "image": "https://resource.chunyu.mobi/@/media/images/image2.jpg",
          "name": "測(cè)試醫(yī)生2",
          "price": 10000,
          "purchase_num": 1000,
          "title": "主任醫(yī)師",
          "is_famous_doctor": true,
          "tel_online": true,
          "tel_price": "{\"10\": 16000, \"15\": 24000, \"20\": 40000, \"30\": -1}"
        }]
      }
    
  

搜索醫(yī)生接口

說(shuō)明:按照疾病、癥狀、醫(yī)院、科室、醫(yī)生名搜索醫(yī)生(此接口為搜索接口非過(guò)濾接口,返回的搜索結(jié)果可能與搜索詞存在偏差),一次返回20個(gè)醫(yī)生

URL: /cooperation/server/doctor/search_doctor/

請(qǐng)求方式: POST

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

名稱 說(shuō)明 類型 長(zhǎng)度 必要 備注
user_id 用戶id String 32 用戶唯一標(biāo)識(shí),合作方定義(可為字母、數(shù)字、下劃線或其組合)
partner 合作方標(biāo)識(shí) String 32 partner_name
atime 時(shí)間戳 Long 64 當(dāng)前UNIX TIMESTAMP簽名時(shí)間戳 (如:137322417)
sign 簽名 String 32 必須在服務(wù)器端生成 生成方法
query_text 查找參數(shù) String 100 搜索詞(癥狀,疾病,醫(yī)院,科室,醫(yī)生名)
page 頁(yè)碼 int 32 取值范圍1-10
province 省份 String 具體查看
city 城市 String 具體查看
title 職稱 String 職稱篩選,可選項(xiàng)[主任醫(yī)師, 副主任醫(yī)師, 主治醫(yī)師, 醫(yī)師, 心理咨詢師, 公共營(yíng)養(yǎng)師]
min_price 最低圖文價(jià)格 不傳則不限制最低價(jià)
max_price 最高圖文價(jià)格 不傳則不限制最高價(jià)
service_type 服務(wù)類型 String 不填為默認(rèn)獲取開通圖文服務(wù)的醫(yī)生;值為inquiry表示獲取開通普通電話服務(wù)的醫(yī)生,值為expert_call表示獲取開通專家電話服務(wù)的醫(yī)生,值為expert_register_apply表示獲取開通專家預(yù)約掛號(hào)服務(wù)的醫(yī)生;支持多選,多選時(shí)以|分隔

返回:

名稱 說(shuō)明 類型 長(zhǎng)度 必要 備注
doctors 醫(yī)生list array
clinic_name 科室名稱 String
second_clinic_name 二級(jí)科室名稱 String
hospital_grade 醫(yī)院等級(jí) String 如:三級(jí)甲等
good_at 擅長(zhǎng) String
hospital_name 醫(yī)院名稱 String
image 醫(yī)生頭像 String 200 醫(yī)生照片的 url
id 醫(yī)生id String
name 醫(yī)生姓名 String
price 價(jià)格 Int 單位為分,不需要緩存醫(yī)生價(jià)錢信息,該信息必須實(shí)時(shí)獲取
purchase_num 購(gòu)買數(shù)量 Int
title 職稱 string
is_famous_doctor 是否是名醫(yī)咨詢 bool 名醫(yī)咨詢10次交互/48h后問(wèn)題關(guān)閉;普通定向問(wèn)題30次交互/48h后問(wèn)題關(guān)閉
tel_online 是否可以預(yù)約電話問(wèn)診 bool 是否支持電話問(wèn)診下單
tel_price 電話問(wèn)診時(shí)長(zhǎng)對(duì)應(yīng)的價(jià)格 string json格式,key為時(shí)長(zhǎng),value為對(duì)應(yīng)的價(jià)格,單位分。-1為此時(shí)長(zhǎng)服務(wù)未開通
expert_call_price_fen 專家電話價(jià)格 Int 單位為分,-1為此服務(wù)未開通
expert_register_price_fen 專家預(yù)約掛號(hào)價(jià)格 Int 單位為分,-1為此服務(wù)未開通
error 錯(cuò)誤碼 Int 32 0 代表成功,其它 代表異常
error_msg 異常信息 String

post數(shù)據(jù)示例

    
      {
        "user_id": "test_user",
        "query_text": "頭疼",
        "famous_doctor": "1",
        "page": "1",
        "partner": "test",
        "sign": "d47372cb2e28ba13",
        "atime": "1608261465"
      }
    
  

響應(yīng)示例

    
      {
        "error": 0,
        "doctors": [{
          "clinic_name": "兒科",
          "second_clinic_name": "小兒科",
          "good_at": "發(fā)育遲緩、頭痛、遺傳代謝病",
          "hospital_name": "北京第一醫(yī)院",
          "hospital_grade": "三級(jí)甲等",
          "id": "0000001",
          "image": "https://resource.chunyu.mobi/@/media/images/image1.jpg",
          "name": "測(cè)試醫(yī)生",
          "price": 100,
          "purchase_num": 771,
          "title": "主治醫(yī)師",
          "is_famous_doctor": false,
          "tel_online": false,
          "tel_price": "{\"10\": -1, \"15\": -1, \"20\": -1, \"30\": -1}"
        },
        {
          "clinic_name": "兒科",
          "second_clinic_name": "小兒科",
          "good_at": "多動(dòng)癥、小兒癲癇、抽動(dòng)癥",
          "hospital_name": "解放軍總醫(yī)院",
          "hospital_grade": "三級(jí)甲等",
          "id": "0000002",
          "image": "https://resource.chunyu.mobi/@/media/images/image2.jpg",
          "name": "測(cè)試醫(yī)生2",
          "price": 10000,
          "purchase_num": 1000,
          "title": "主任醫(yī)師",
          "is_famous_doctor": true,
          "tel_online": true,
          "tel_price": "{\"10\": 16000, \"15\": 24000, \"20\": 40000, \"30\": -1}"
        }]
      }
    
  

創(chuàng)建定向問(wèn)題

說(shuō)明:付費(fèi)記錄有效時(shí)間為1小時(shí)

URL: /cooperation/server/problem/create_oriented_problem/

請(qǐng)求方式: POST

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

名稱 說(shuō)明 類型 長(zhǎng)度 必要 備注
doctor_id 購(gòu)買的醫(yī)生id String
content 首次提問(wèn)內(nèi)容 String 5120 數(shù)據(jù)結(jié)構(gòu),其中 patient_meta 不能傳遞多次,以第一次內(nèi)容的為準(zhǔn)。
partner 合作方標(biāo)識(shí) String 32 我要申請(qǐng)
partner_order_id 合作方支付ID String 需要是唯一標(biāo)識(shí)的支持字母與數(shù)字組合
price 訂單價(jià)格 Int 單位為分
user_id 用戶名 String 32 用戶唯一標(biāo)識(shí),合作方定義(可為字母、數(shù)字、下劃線或其組合)
sign 簽名 String 32 必須在服務(wù)器端生成 生成方法
atime 簽名時(shí)間戳 Long 64 當(dāng)前UNIX TIMESTAMP簽名時(shí)間戳 (如:137322417)

返回:

名稱 說(shuō)明 類型 長(zhǎng)度 必要 備注
problem_id 問(wèn)題id int
error 錯(cuò)誤碼 Int 32 0 代表成功,其它 代表異常
error_msg 異常信息 String

post數(shù)據(jù)示例

    
      {
        "doctor_id": "clinic_web_ae8068a4df5f189e",
        "content": "[{\"type\": \"patient_meta\",\"age\": \"20歲\",\"sex\": \"男\(zhòng)"},{\"type\": \"text\",\"text\": \"測(cè)試創(chuàng)建定向問(wèn)診問(wèn)題\"}]",
        "partner": "test",
        "partner_order_id": "000001",
        "price": "200",
        "user_id": "test_user",
        "sign": "162c86f9d6c94a65",
        "atime": "1608262345"
      }
    
  

響應(yīng)示例

    
      {
        "problem_id": 443258142,
        "error": 0,
        "error_msg": ""
      }
    
  

付費(fèi)問(wèn)題退款

說(shuō)明:第三方可借助該接口實(shí)現(xiàn)用戶主動(dòng)發(fā)起付費(fèi)問(wèn)題退款,退款只能在醫(yī)生未回答的情況下才能成功。

URL: /cooperation/server/problem/refund

請(qǐng)求方式: POST

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

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

返回:

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

post數(shù)據(jù)示例

    
      {
        "user_id": "test_user",
        "problem_id": "443258127",
        "partner": "test",
        "sign": "5a236b488f7eaacc",
        "atime": "1608208460"
      }
    
  

響應(yīng)示例

    
      {
        "error": 0,
        "error_msg": ""
      }
    
  

圖文急診服務(wù)

簡(jiǎn)介

急診服務(wù)是一項(xiàng)高效的圖文問(wèn)診服務(wù)。當(dāng)用戶提問(wèn)后,能夠得到醫(yī)生快速回復(fù)(60秒),圖文急診達(dá)到20次交互或醫(yī)生首次回復(fù)30分鐘后問(wèn)題關(guān)閉。

服務(wù)價(jià)格以商務(wù)合同中敲定的為準(zhǔn),在接口參數(shù)中不做體現(xiàn)。

服務(wù)流程

1. 先獲取圖文急診信息

2. 根據(jù)獲取到的科室和價(jià)格信息創(chuàng)建圖文急診(注意服務(wù)時(shí)間)

獲取圖文急診信息接口

說(shuō)明:獲取春雨圖文急診開通的相關(guān)信息,包括開通的時(shí)間,價(jià)格,科室

URL: /cooperation/server/problem/get_emergency_graph_info/

請(qǐng)求方式:POST

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

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

返回:

名稱 說(shuō)明 類型 長(zhǎng)度 必要 備注
error 結(jié)果 Int 0 成功,1 失敗
clinic_info 科室信息list Array
clinic_no 科室號(hào) str 10 '1':婦科, '15':眼科, '21':產(chǎn)科, 'fa' :小兒科,'ha':皮膚科
clinic_name 科室名 str 32
begin 服務(wù)開始時(shí)間 str 10 格式為24小時(shí)制
end 服務(wù)結(jié)束時(shí)間 str 10 格式為24小時(shí)制
disabled 是否可用 Boolean 32 沒(méi)有值班醫(yī)生時(shí)服務(wù)不可用,此字段為True, 可用時(shí)無(wú)此字段。不存在則默認(rèn)為False

post數(shù)據(jù)示例

    
      {
        "user_id": "test_user",
        "partner": "test",
        "sign": "6de9382451be403f",
        "atime": "1608276441"
      }
    
  

響應(yīng)示例

    
      {
        "error": 0,
        "clinic_info": [
          {
            "clinic_no": "fa",
            "clinic_name": "小兒科",
            "begin": "07:00",
            "end": "15:45",
          },
          {
            "clinic_no": "ha",
            "clinic_name": "皮膚科",
            "disabled": true
          }
        ]
      }
    
  

創(chuàng)建急診問(wèn)題接口

說(shuō)明:用戶確定需要問(wèn)診的急診科室,調(diào)用此接口生成付費(fèi)急診問(wèn)題

URL: /cooperation/server/problem/create_emergency_graph/

請(qǐng)求方式:POST

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

名稱 說(shuō)明 類型 長(zhǎng)度 必要 備注
user_id 用戶ID String 32 用戶唯一標(biāo)識(shí),合作方定義(可為字母、數(shù)字、下劃線或其組合)
partner 合作方標(biāo)識(shí) String 32 partner_name
content 問(wèn)題內(nèi)容 String 5120 數(shù)據(jù)結(jié)構(gòu),其中 patient_meta 不能傳遞多次,以第一次內(nèi)容的為準(zhǔn)。
sign 簽名 String 32 必須在服務(wù)器端生成 生成方法
atime 時(shí)間戳 Long 64 當(dāng)前UNIX TIMESTAMP簽名時(shí)間戳 (如:137322417)
partner_order_id 合作方支付ID String 32 唯一標(biāo)識(shí)本次支付行為
clinic_no 科室號(hào) String 10 必須是春雨開通急診的科室

返回:

名稱 說(shuō)明 類型 長(zhǎng)度 必要 備注
problem_id 問(wèn)題id Int 64 創(chuàng)建的問(wèn)題ID
error 錯(cuò)誤碼 Int
error_msg 錯(cuò)誤原因 String

post數(shù)據(jù)示例

    
      {
        "user_id": "test_user",
        "content": "[{\"type\": \"patient_meta\",\"age\": \"15歲\",\"sex\": \"男\(zhòng)"},{\"type\": \"text\",\"text\": \"測(cè)試創(chuàng)建急診問(wèn)診問(wèn)題\"}]",
        "clinic_no": "fa",
        "partner_order_id": "1700",
        "partner": "test",
        "sign": "64bff638925fecea",
        "atime": "1608284147"
      }
    
  

響應(yīng)示例

    
      {
        "problem_id": 443258195,
        "error": 0,
        "error_msg": ""
      }
    
  

通用接口

問(wèn)題追問(wèn)接口

說(shuō)明:通過(guò)此接口實(shí)現(xiàn)用戶對(duì)醫(yī)生的追問(wèn)

URL: /cooperation/server/problem_content/create

請(qǐng)求方式: POST

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

名稱 說(shuō)明 類型 長(zhǎng)度 必要 備注
user_id 用戶名 String 32 用戶唯一標(biāo)識(shí),合作方定義(可為字母、數(shù)字、下劃線或其組合)
partner 合作方標(biāo)識(shí) String 32 我要申請(qǐng)
problem_id 問(wèn)題ID Int 32
content String String 數(shù)據(jù)結(jié)構(gòu),可以傳遞 patient_meta 之外的其余三種類型的contentItem。
sign 簽名 String 32 必須在服務(wù)器端生成 生成方法
atime 簽名時(shí)間戳 Long 64 當(dāng)前UNIX TIMESTAMP簽名時(shí)間戳 (如:137322417)

返回:

名稱 說(shuō)明 類型 長(zhǎng)度 必要 備注
content_id 回復(fù)編號(hào) Long 64 當(dāng)前回復(fù)內(nèi)容的id
error 錯(cuò)誤碼 Int 32 0 代表成功,其它 代表異常
error_msg 異常信息 String

post數(shù)據(jù)示例

    
      {
        "user_id": "test_user",
        "partner": "test",
        "problem_id": "443258196",
        "content": "[{\"type\": \"text\",\"text\": \"測(cè)試追問(wèn)\"}]",
        "sign": "1bad37f433370896",
        "atime": "1608285064"
      }
    
  

響應(yīng)示例

    
      {
        "error": 0,
        "content_id": 11536441
      }
    
  

問(wèn)題詳情接口

說(shuō)明:通過(guò)此接口獲取用戶提問(wèn)問(wèn)題的詳情

URL: /cooperation/server/problem/detail

請(qǐng)求方式: POST

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

名稱 說(shuō)明 類型 長(zhǎng)度 必要 備注
user_id Int String 用戶唯一標(biāo)識(shí),合作方定義(可為字母、數(shù)字、下劃線或其組合)
partner 合作方標(biāo)識(shí) String 我要申請(qǐng)
problem_id 問(wèn)題ID Int 64
sign 簽名 String 必須在服務(wù)器端生成 生成方法
atime 簽名時(shí)間戳 Long 64 當(dāng)前UNIX TIMESTAMP簽名時(shí)間戳 (如:137322417)
last_content_id 最后一個(gè)回復(fù)編號(hào) Long 64 參考問(wèn)題追問(wèn)返回的content_id,會(huì)返回所有大于此編號(hào)的回復(fù)列表

返回:

名稱 說(shuō)明 類型 長(zhǎng)度 必要 備注
problem 問(wèn)題信息 dict
id 問(wèn)題 ID Int
status 問(wèn)題狀態(tài) String

n 新問(wèn)題

a 已認(rèn)領(lǐng)---醫(yī)生認(rèn)領(lǐng),等待醫(yī)生回答

s 已回復(fù)

c 已關(guān)閉

p 被舉報(bào)---因?yàn)楹羞`禁詞/辱罵醫(yī)生等原因被舉報(bào)

狀態(tài)轉(zhuǎn)換示意圖 點(diǎn)擊查看

ask 提問(wèn)內(nèi)容 String 20 提問(wèn)內(nèi)容
clinic_no 問(wèn)題所在的科室號(hào) String 20 N
star 問(wèn)題星級(jí) Int 32 (4,5 為好評(píng), 1,2 為差評(píng),3 為中評(píng),-1 暫未 評(píng)價(jià))
interaction 交互次數(shù) Int 32 詳細(xì)定義:點(diǎn)擊查看
content 內(nèi)容 array
id 回復(fù)編號(hào) Long
created_time_ms String 創(chuàng)建問(wèn)題時(shí)間戳
type 類型 String 200 p是用戶回復(fù),d是醫(yī)生回復(fù)
content array 同問(wèn)題追問(wèn)的 content數(shù)據(jù)結(jié)構(gòu)
subtype string 20 返回值標(biāo)識(shí)為summary,則表示這條醫(yī)生回復(fù)為醫(yī)生總結(jié)信息;當(dāng)醫(yī)生回復(fù)內(nèi)容為非總結(jié)信息時(shí),不返回這個(gè)字段
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 科室號(hào) String 20 問(wèn)題列表
hospital 醫(yī)院名字 String 100
error 錯(cuò)誤碼 Int 32 0 代表成功,其它代表異常
error_msg 異常信息 String

post數(shù)據(jù)示例

    
      {
        "user_id": "test_user",
        "problem_id": "443258234",
        "partner": "test",
        "sign": "d3ba697b786a9a17",
        "atime": "1608449384"
      }
    
  

響應(yīng)示例

    
      {
        "problem": {
          "id": 443258234,
          "status": "a",
          "ask": "醫(yī)生你好,測(cè)試創(chuàng)建眾包升級(jí)問(wèn)題(男,40歲)",
          "clinic_no": "2",
          "star": -1,
          "level": "",
          "has_assessed": false,
          "interaction": 1
        },
        "content": [
          {
            "id": 11536625,
            "type": "p",
            "content": "[{\"text\": \"醫(yī)生你好,測(cè)試創(chuàng)建眾包升級(jí)問(wèn)題(男,40歲)\", \"type\": \"text\"}]",
            "created_time_ms": 1608450103000
          },
          {
            "id": 11536628,
            "type": "d",
            "content": "[{\"text\": \"快速醫(yī)生回復(fù),時(shí)間: 2020-12-20 15:42:02.676034\", \"type\": \"text\"}]",
            "created_time_ms": 1608450123000
          },
          {
            "id": 11536629,
            "type": "p",
            "content": "[{\"text\": \"測(cè)試追問(wèn)\", \"type\": \"text\"}]",
            "created_time_ms": 1608450134000
          }
        ],
        "doctor": {
          "id": "clinic_web_ae8068a4df5f189e",
          "name": "測(cè)試醫(yī)生",
          "image": "https://test.chunyutianxia.com/media/images/fc7d/8968fe2e5cb5?imageMogr2/thumbnail/150x",
          "title": "主治醫(yī)師",
          "level_title": "二級(jí)甲等醫(yī)院主治醫(yī)師",
          "clinic": "2",
          "hospital": "上饒市婦幼保健院"
        },
        "error": 0,
        "error_msg": ""
      }
    
  

醫(yī)生詳情接口

說(shuō)明:醫(yī)生詳細(xì)信息以此接口返回的數(shù)據(jù)為準(zhǔn)

URL: /cooperation/server/doctor/detail

請(qǐng)求方式: POST

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

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

返回:

名稱 說(shuō)明 類型 長(zhǎng)度 必要 備注
id 醫(yī)生 ID String 32 醫(yī)生 ID
name 姓名 String 32 姓名
image 頭像地址 String 頭像地址
title 職稱 String 職稱
clinic_name 科室 String 科室
hospital 醫(yī)院名字 String 醫(yī)院名字
hospital_grade 醫(yī)院級(jí)別 String 醫(yī)院級(jí)別
good_at 擅長(zhǎng)領(lǐng)域 String 擅長(zhǎng)領(lǐng)域
recommend_rate 推薦指數(shù) String 最高100
description 專家簡(jiǎn)介 String 專家簡(jiǎn)介
price 圖文咨詢 Int 單位為分
solution_score 專業(yè)度指數(shù) int 最高100
good_rate 好評(píng)率 String 最高100,如‘98.8’
tags 醫(yī)生標(biāo)簽 Array String Array
reward_num 送心意數(shù)量 int
reply_num 咨詢數(shù) int
fans_num 粉絲數(shù) int
is_famous_doctor 是否是名醫(yī)咨詢 bool 名醫(yī)咨詢10次交互/48h后問(wèn)題關(guān)閉;普通定向問(wèn)題30次交互/48h后問(wèn)題關(guān)閉
tel_price 電話咨詢價(jià)格 json key:時(shí)長(zhǎng)(單位:分鐘),value:價(jià)格(單位:分)
tel_online 電話咨詢狀態(tài) bool 醫(yī)生的電話咨詢是否開通
expert_call_price_fen 專家電話價(jià)格 Int 單位為分,-1為此服務(wù)未開通
expert_register_price_fen 專家預(yù)約掛號(hào)價(jià)格 Int 單位為分,-1為此服務(wù)未開通
education 教育背景 String
achievement 學(xué)術(shù)成果 String
welcome 醫(yī)生寄語(yǔ) String
license_no 執(zhí)業(yè)證書編號(hào) String "1234*********65"
is_active 是否在線 Bool
error 錯(cuò)誤碼 Int 32 0 代表成功,其它代表異常
error_msg 異常信息 String

post數(shù)據(jù)示例

    
      {
        "user_id": "test_user",
        "doctor_id": "04c580dbeb2007220123",
        "partner": "test",
        "sign": "4d7de1d90f54c62d",
        "atime": "1608518154"
      }
    
  

響應(yīng)示例

    
      {
        "id": "04c580dbeb2007220123",
        "name": "測(cè)試醫(yī)生",
        "image": "https://resource.chunyu.mobi/@/media/images/99b3/5f9530432279?imageMogr2/thumbnail/150x",
        "title": "主治醫(yī)師",
        "clinic_name": "小兒科",
        "hospital": "北京301醫(yī)院",
        "hospital_grade": "三級(jí)甲等",
        "good_at": "臨床工作20多年,經(jīng)驗(yàn)豐富,擅長(zhǎng)小兒呼吸道感染等診治。",
        "solution_score": 98,
        "recommend_rate": 88,
        "good_rate": 92.8,
        "description": "",
        "price": 2500,
        "tags": [
          "百?gòu)?qiáng)醫(yī)院",
          "從業(yè)26年",
          "北京市市"
        ],
        "reward_num": 7,
        "reply_num": 942,
        "fans_num": 55,
        "is_famous_doctor": false,
        "education": "1994年上海第二醫(yī)科大學(xué)兒科系畢業(yè),2006年去香港瑪麗醫(yī)院進(jìn)修。",
        "achievement": "",
        "welcome": "歡迎關(guān)注我的小兒科個(gè)人診所,希望能為你提供健康方面的幫助。",
        "tel_price": "{\"10\": 1000, \"15\": -1, \"20\": -1, \"30\": -1}",
        "tel_online": true,
        "error": 0,
        "error_msg": ""
      }
    
  

醫(yī)生總結(jié)信息

說(shuō)明:

在咨詢過(guò)程中或服務(wù)關(guān)閉后7天內(nèi),醫(yī)生可通過(guò)圖文形式向用戶下發(fā)總結(jié)。醫(yī)生總結(jié)是醫(yī)生的可選交流方式,并非所有問(wèn)題都會(huì)下發(fā)總結(jié)。

總結(jié)信息可通過(guò)兩種方式傳達(dá)到合作方:1、通過(guò)【醫(yī)生回復(fù)通知接口】以回調(diào)形式同步;2、通過(guò)【問(wèn)題詳情接口】同步。在這兩種方式中,會(huì)對(duì)醫(yī)生總結(jié)進(jìn)行特殊標(biāo)識(shí),具體請(qǐng)參見(jiàn)接口規(guī)范。

醫(yī)生可多次撰寫總結(jié),但春雨平臺(tái)側(cè)每個(gè)問(wèn)題只會(huì)保留一份總結(jié),以最后一次為準(zhǔn)(即推送可能收到多次,但問(wèn)題詳情接口里只會(huì)體現(xiàn)一份總結(jié),合作方可酌情設(shè)計(jì)該功能)。

查詢問(wèn)題分配科室接口

說(shuō)明:該接口可用于查詢眾包(升級(jí))問(wèn)題將會(huì)被分配的科室號(hào);春雨支持創(chuàng)建眾包(升級(jí))問(wèn)題時(shí)指定科室問(wèn)診,合作方創(chuàng)建問(wèn)題時(shí)傳給春雨科室信息,就會(huì)按傳遞的科室進(jìn)行分診,以此實(shí)現(xiàn)用戶自主選擇科室;如果不傳則春雨自動(dòng)分配; 另外如果合作方選擇的科室是錯(cuò)誤的話,醫(yī)生側(cè)可將該問(wèn)題轉(zhuǎn)診至正確的科室,最終顯示的分診科室可能與最初選擇不同。

URL: /cooperation/server/problem/get_problem_clinic_no/

請(qǐng)求方式: POST

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

名稱 說(shuō)明 類型 長(zhǎng)度 必要 備注
user_id 用戶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)
ask 問(wèn)題的文本 String 100 首次提問(wèn)的問(wèn)題文本

返回:

名稱 說(shuō)明 類型 長(zhǎng)度 必要 備注
clinic_no 結(jié)果 String 10 問(wèn)題科室編號(hào)
error 錯(cuò)誤碼 Int 32 0 代表成功,其它 代表異常
error_msg 異常信息 String

post數(shù)據(jù)示例

    
      {
        "user_id": "test_user",
        "partner": "test",
        "ask": "渾身發(fā)熱,沒(méi)勁",
        "sign": "fdb57eee1bb66c91",
        "atime": "1608518632"
      }
    
  

響應(yīng)示例

    
      {
        "error": 0,
        "error_msg": "",
        "clinic_no": "aa"
      }
    
  

評(píng)價(jià)問(wèn)題接口

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

1、問(wèn)題未關(guān)閉時(shí),交互3次以上可進(jìn)行評(píng)價(jià)

2、問(wèn)題關(guān)閉后:關(guān)閉后30天內(nèi)可以評(píng)價(jià);接收評(píng)價(jià)的有效期為問(wèn)題關(guān)閉后30天內(nèi),超過(guò)30天,不能再評(píng)價(jià);測(cè)試環(huán)境的有效期為問(wèn)題關(guān)閉后1小時(shí)

3、評(píng)價(jià)次數(shù)限制:每個(gè)問(wèn)題僅支持接收一次評(píng)價(jià)數(shù)據(jù)

接口信息

URL: /cooperation/server/problem/assess

請(qǐng)求方式: POST

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

名稱 說(shuō)明 類型 長(zhǎng)度 必要 備注
user_id 用戶名 String 32 用戶唯一標(biāo)識(shí),合作方定義(可為字母、數(shù)字、下劃線或其組合)
partner 合作方標(biāo)識(shí) String 32 我要申請(qǐng)
problem_id 問(wèn)題ID Int 32
assess_info 評(píng)價(jià)信息 String 32 數(shù)據(jù)結(jié)構(gòu),生成方式可參考數(shù)據(jù)結(jié)構(gòu)
如:'{"level": "best", "tag_keys":["3201", "3102"]}'
level 評(píng)價(jià)等級(jí) String 32 'best','good','bad'
tag_keys 評(píng)價(jià)標(biāo)簽數(shù)組 Array 標(biāo)簽必須與 level 匹配
content String String 數(shù)據(jù)結(jié)構(gòu),只能傳遞text類型的contentItem。
sign 簽名 String 32 必須在服務(wù)器端生成 生成方法
atime 簽名時(shí)間戳 Long 64 當(dāng)前UNIX TIMESTAMP簽名時(shí)間戳 (如:137322417)
    
      {
        "bad": {
        "1101": '不友好',
        "1102": '不細(xì)致',
        "1201": '等好久沒(méi)回復(fù)',
        "1301": '完全聽(tīng)不懂',
        "1302": '感覺(jué)不專業(yè)',
        "1303": '沒(méi)有幫助',}
        "good": {
        "2101": '希望更熱情',
        "2102": '希望更細(xì)致',
        "2201": '希望回復(fù)更快',
        "2301": '希望講得更透徹',}
        "best": {
        "3101": '態(tài)度非常好',
        "3102": '非常清楚',
        "3201": '回復(fù)很及時(shí)',
        "3301": '非常專業(yè)認(rèn)真',
        "3302": '意見(jiàn)很有幫助',
        "3303": '非常敬業(yè)',}
      }
    
  

返回:

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

post數(shù)據(jù)示例

    
      {
        "user_id": "test_user",
        "partner": "test",
        "problem_id": "443258196",
        "assess_info": "{\"level\": \"best\", \"tag_keys\":[\"3201\", \"3102\"]}",
        "content": "[{\"type\": \"text\",\"text\": \"醫(yī)生解答的挺好的,給個(gè)好評(píng)。\"}]",
        "sign": "fdb57eee1bb66c91",
        "atime": "1608518632"
      }
    
  

響應(yīng)示例

    
      {
        "error": 0,
        "error_msg": ""
      }
    
  

問(wèn)題刪除接口

刪除問(wèn)題后,"我的提問(wèn)歷史"接口中,會(huì)刪除掉這個(gè)問(wèn)題。

注意:?jiǎn)栴}未關(guān)閉時(shí)調(diào)用此接口時(shí),會(huì)先關(guān)閉問(wèn)題。請(qǐng)用戶確保問(wèn)診完畢,不需要和醫(yī)生交互后使用。

URL: /cooperation/server/problem/delete

請(qǐng)求方式: POST

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

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

返回:

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

post數(shù)據(jù)示例

    
      {
        "user_id": "test_user",
        "partner": "test",
        "problem_id": "443258241",
        "atime": "1608519397",
        "sign": "7d752c229c9cd583"
      }
    
  

響應(yīng)示例

    
      {
        "error": 0,
        "error_msg": ""
      }
    
  

問(wèn)題關(guān)閉接口

說(shuō)明:第三方通過(guò)此接口主動(dòng)關(guān)閉問(wèn)題,主動(dòng)關(guān)閉條件:狀態(tài)不是已關(guān)閉且醫(yī)生有回復(fù)

URL: /cooperation/server/problem/close

請(qǐng)求方式: POST

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

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

返回:

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

post數(shù)據(jù)示例

    
      {
        "user_id": "test_user",
        "partner": "test",
        "problem_id": "443258242",
        "atime": "1608519713",
        "sign": "8fddaee19d525886"
      }
    
  

響應(yīng)示例

    
      {
        "error": 0,
        "error_msg": ""
      }
    
  

我的提問(wèn)歷史

說(shuō)明:通過(guò)此接口獲取用戶的提問(wèn)歷史

URL: /cooperation/server/problem/list/my

請(qǐng)求方式: POST

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

名稱 說(shuō)明 類型 長(zhǎng)度 必要 備注
user_id 用戶名 String 32 用戶唯一標(biāo)識(shí),合作方定義(可為字母、數(shù)字、下劃線或其組合)
partner 合作方標(biāo)識(shí) String 32 我要申請(qǐng)
start_num 開始數(shù) Int 32 用于支持翻頁(yè)功能,從 0 開始計(jì)數(shù)
count 每次取的問(wèn)題數(shù) Int 32 最大200
sign 簽名 String 32 必須在服務(wù)器端生成 生成方法
atime 簽名時(shí)間戳 Long 64 當(dāng)前UNIX TIMESTAMP簽名時(shí)間戳 (如:137322417)

返回:

名稱 說(shuō)明 類型 長(zhǎng)度 必要 備注
problem 問(wèn)題信息 dict
id 問(wèn)題 ID Int 32
status 問(wèn)題狀態(tài) String

n 新問(wèn)題

a 已認(rèn)領(lǐng)---醫(yī)生認(rèn)領(lǐng),等待醫(yī)生回答

s 已回復(fù)

c 已關(guān)閉

p 被舉報(bào)---因?yàn)楹羞`禁詞/辱罵醫(yī)生等原因被舉報(bào)

狀態(tài)轉(zhuǎn)換示意圖 點(diǎn)擊查看

price 問(wèn)題支付價(jià)格 Int 問(wèn)題支付價(jià)格,單位: 元
to_doc 是否是針對(duì)醫(yī)生的定向提問(wèn) Boolean
title 問(wèn)題標(biāo)題 String 200 問(wèn)題標(biāo)題
ask 提問(wèn)內(nèi)容 String 20 提問(wèn)內(nèi)容
clinic_no 問(wèn)題所在的科室號(hào) String 20 N
clinic_name 問(wèn)題所在的科室名字 String 100
has_answer 是否被醫(yī)生答復(fù) Boolean
need_assess 問(wèn)題是否需要被評(píng)價(jià) Boolean
created_time_ms 創(chuàng)建時(shí)間的毫秒數(shù) Long 64
created_time 創(chuàng)建時(shí)間的字符串格式 String '%Y-%m-%d %H: %M:%S'
star 問(wèn)題星級(jí) Int 32 (4,5 為好評(píng), 1,2 為差評(píng),3 為中評(píng),-1 暫未 評(píng)價(jià))
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 科室號(hào) String 20 問(wèn)題列表
hospital 醫(yī)院名字 String 100

post數(shù)據(jù)示例

    
      {
        "user_id": "test_user",
        "start_num": "0",
        "count": "10",
        "partner": "test",
        "sign": "3bb28a7c0f4a463e",
        "atime": "1608520177"
      }
    
  

響應(yīng)示例

    
      [{
        "problem": {
          "id": 443258245,
          "status": "a",
          "star": 5,
          "to_doc": false,
          "price": 6.0,
          "title": "醫(yī)生您好,測(cè)試創(chuàng)建眾包問(wèn)題(...",
          "ask": "醫(yī)生您好,測(cè)試創(chuàng)建眾包問(wèn)題(男,40歲)",
          "clinic_no": "2",
          "has_answer": true,
          "flag": "n",
          "created_time_ms": 1608519977000,
          "assess_remark": "挺好的,評(píng)價(jià)一下這個(gè)。",
          "clinic_name": "兒科",
          "created_time": "2020-12-21 11:06:17",
          "need_assess": false,
          "level": "best"
        },
        "doctor": {
          "id": "clinic_web_ae8068a4df5f189e",
          "name": "測(cè)試醫(yī)生",
          "title": "主治醫(yī)師",
          "image": "https://test.chunyutianxia.com/media/images/fc7d/8968fe2e5cb5?imageMogr2/thumbnail/150x",
          "clinic_no": "2",
          "clinic": "小兒科",
          "hospital": "上饒市婦幼保健院",
          "hospital_grade": "二級(jí)甲等",
          "level_title": "二級(jí)甲等醫(yī)院主治醫(yī)師"
        }
      }]
    
  

H5資源訪問(wèn)登錄跳轉(zhuǎn)

說(shuō)明:由于接入方用戶端沒(méi)有登錄狀態(tài),在使用某些H5鏈接資源時(shí),需要將要訪問(wèn)的鏈接嵌套此接口,并實(shí)時(shí)生成鏈接下發(fā)給用戶端進(jìn)行訪問(wèn),已完成登錄并訪問(wèn)。 文檔中的接口簽名驗(yàn)證機(jī)制同春雨開放平臺(tái)問(wèn)診對(duì)接;

URL: /cooperation/saas/login_redirect/

請(qǐng)求方式: GET

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

名稱 說(shuō)明 類型 必要 備注
url 問(wèn)診記錄url String 需要進(jìn)行URL編碼
partner 合作方標(biāo)識(shí) String
user_id 用戶名 String 用戶唯一標(biāo)識(shí),合作方定義(可為字母、數(shù)字、下劃線或其組合)
sign 簽名 String 必須在服務(wù)器端生成 生成方法
atime 簽名時(shí)間戳 Long 當(dāng)前UNIX TIMESTAMP簽名時(shí)間戳 (如:137322417)

示例:

其中問(wèn)診記錄測(cè)試環(huán)境url:

    
      
        http://www.jjch2r.cn/cooperation/wap/my_all_services_page/?partner=xxx&from_saas=1
      
    
  

嵌套登錄接口后下發(fā)給用戶端:

    
      
        http://www.jjch2r.cn/cooperation/saas/login_redirect/?url=https%3A%2F%2Fwww.jjch2r.cn%2Fcooperation%2Fwap%2Fmy_all_services_page%2F%3Fpartner%3Dxxxx%26from_saas%3D1&partner=xxx&atime=1676883201&user_id=test_user1&sign=1f46b8e32d7ebd2e
      
    
  

退款及舉報(bào)邏輯

針對(duì)眾包升級(jí)、定向圖文類型的付費(fèi)問(wèn)題,涉及到如下退款場(chǎng)景時(shí),將下發(fā)對(duì)應(yīng)的系統(tǒng)通知和文案

退款類型

1、退款類型共包括5類,具體參見(jiàn)下表《退款類型》

2、舉報(bào)邏輯與被舉報(bào)引起的退款(具體參見(jiàn)表《因被舉報(bào)引起的退款邏輯》)

規(guī)則說(shuō)明1:?jiǎn)栴}因被系統(tǒng)舉報(bào)或被醫(yī)生舉報(bào)可能引發(fā)退款,舉報(bào)邏輯共包括4種類型,其中3種涉及退款;

規(guī)則說(shuō)明2:凡被舉報(bào)的問(wèn)題,平臺(tái)側(cè)都會(huì)下發(fā)多次推送通知,第1次下發(fā)關(guān)閉通知,是否做退款處理請(qǐng)以第2次通知為準(zhǔn),具體處理邏輯及文案細(xì)節(jié)見(jiàn)表;

退款類型 說(shuō)明 前置條件 refund_type取值 春雨返回文案 建議顯示文案(合作方自主決定是否顯示)
醫(yī)生拒絕 付費(fèi)問(wèn)題被醫(yī)生拒絕觸發(fā)退款 無(wú) 1 抱歉,醫(yī)生評(píng)估您的問(wèn)題后,認(rèn)為自身經(jīng)驗(yàn)與您的問(wèn)題不大匹配或無(wú)法及時(shí)回復(fù),已為您退款,請(qǐng)選擇其他醫(yī)生 抱歉,醫(yī)生評(píng)估您的問(wèn)題后,認(rèn)為自身經(jīng)驗(yàn)與您的問(wèn)題不大匹配或無(wú)法及時(shí)回復(fù),已為您退款,請(qǐng)選擇其他醫(yī)生
用戶取消 當(dāng)問(wèn)題未被醫(yī)生回復(fù)時(shí),由用戶主動(dòng)發(fā)起退款 無(wú) 2 患者取消
超時(shí)退款 當(dāng)付費(fèi)問(wèn)題在有效時(shí)間內(nèi)未被醫(yī)生接題,會(huì)被系統(tǒng)自動(dòng)關(guān)閉,并向用戶退款 無(wú) 3 超時(shí)退款 您的問(wèn)題超時(shí)未回復(fù)已自動(dòng)退款
客服退款 由于各種原因,比如用戶或合作方投訴等,由春雨客服審核并操作退款 客服審核后認(rèn)為該訂單可退 4 (客服具體輸入的內(nèi)容) 已為您退款,請(qǐng)選擇其他醫(yī)生
被舉報(bào)退款 舉報(bào)邏輯共包括4種類型,其中3種涉及退款,具體參見(jiàn)下圖 無(wú) 5 (見(jiàn)下圖) (見(jiàn)下圖)

因被舉報(bào)引起的退款邏輯

問(wèn)題被舉報(bào)時(shí)會(huì)被立即關(guān)閉。若此時(shí)醫(yī)生尚未回復(fù),則退款;若醫(yī)生回復(fù)后被醫(yī)生舉報(bào),則先關(guān)閉問(wèn)題,由客服審核舉報(bào),如果醫(yī)生舉報(bào)正確,則不退款;醫(yī)生舉報(bào)錯(cuò)誤則退款并降低醫(yī)生的指數(shù)。通知關(guān)閉情況見(jiàn)圖:

黑名單邏輯

當(dāng)問(wèn)題被醫(yī)生舉報(bào)并達(dá)到一定次數(shù)時(shí),該用戶將被拉入春雨平臺(tái)的黑名單中;當(dāng)用戶被拉入黑名單后,將導(dǎo)致該用戶后續(xù)創(chuàng)建問(wèn)題失敗.

錯(cuò)誤信息為:"因違背提問(wèn)原則,此功能暫不可用。如有疑問(wèn)請(qǐng)聯(lián)系春雨客服"

回調(diào)管理

回復(fù)通知接口

當(dāng)服務(wù)被醫(yī)生回復(fù)、總結(jié)時(shí),春雨主動(dòng)請(qǐng)求合作方配置的鏈接地址,傳遞醫(yī)生回復(fù)數(shù)據(jù)。

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


URL: 即合作方管理后臺(tái)-賬戶管理-信息配置中填寫的回復(fù)回調(diào)路徑

請(qǐng)求方式: POST

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

名稱 說(shuō)明 類型 長(zhǎng)度 必要 備注
problem_id 問(wèn)題編號(hào) api接入返回Int,web接入返回加密的string
user_id 用戶名 String 32 用戶唯一標(biāo)識(shí),合作方定義(可為字母、數(shù)字、下劃線或其組合)
content 醫(yī)生答復(fù)內(nèi)容 String 數(shù)據(jù)結(jié)構(gòu),可以包含除 patient_meta 之外的三種類型。
left_interactions 剩余交互次數(shù) Int
sign 簽名 String 32 必須在服務(wù)器端生成 生成方法
status 回調(diào)類型 String

reply 醫(yī)生回復(fù)

atime 簽名時(shí)間戳 Long 64 當(dāng)前UNIX TIMESTAMP簽名時(shí)間戳 (如:137322417)
is_summary 是否是醫(yī)生總結(jié) Boolean 是否是醫(yī)生總結(jié)
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)域(醫(yī)生回復(fù)接口里的醫(yī)生信息是簡(jiǎn)版的信息,建議通過(guò)醫(yī)生詳情接口獲取醫(yī)生的詳細(xì)信息)
education_background 教育背景 String

返回:

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

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

當(dāng)服務(wù)關(guān)閉、退款等狀態(tài)變更時(shí),春雨主動(dòng)請(qǐng)求合作方配置的鏈接地址,傳遞訂單狀態(tài)數(shù)據(jù)。

開發(fā)時(shí)請(qǐng)注意:?jiǎn)栴}關(guān)閉和問(wèn)題退款兩個(gè)通知并不互斥,在一些場(chǎng)景中會(huì)先關(guān)閉問(wèn)題


URL: 即合作方管理后臺(tái)-賬戶管理-信息配置中填寫的關(guān)閉回調(diào)路徑

請(qǐng)求方式: POST

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

名稱 說(shuō)明 類型 長(zhǎng)度 必要 備注
problem_id 問(wèn)題編號(hào) api接入返回Int,web接入返回加密的string
user_id 用戶名 String 32 用戶唯一標(biāo)識(shí),合作方定義(可為字母、數(shù)字、下劃線或其組合)
msg 消息內(nèi)容 String
status 問(wèn)題狀態(tài) String

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

refund 問(wèn)題退款

price 退款金額 Int 單位為分
sign 簽名 String 32 必須在服務(wù)器端生成 生成方法
atime 簽名時(shí)間戳 Long 64 當(dāng)前UNIX TIMESTAMP簽名時(shí)間戳 (如:137322417)
refund_type 退款類型 Int 返回值及其類型說(shuō)明:
1代表:醫(yī)生拒絕
2代表:用戶取消
3代表:超時(shí)退款
4代表:客服退款
5代表:被舉報(bào)退款




返回:

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

服務(wù)創(chuàng)建通知接口

當(dāng)圖文服務(wù)創(chuàng)建時(shí),春雨主動(dòng)請(qǐng)求合作方配置的鏈接地址,傳遞訂單狀態(tài)數(shù)據(jù)。


URL: 即合作方管理后臺(tái)-賬戶管理-信息配置中填寫的關(guān)閉回調(diào)路徑

請(qǐng)求方式: POST

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

名稱 說(shuō)明 類型 長(zhǎng)度 必要 備注
problem_id 問(wèn)題編號(hào) api接入返回Int,web接入返回加密的string
user_id 用戶名 String 32 用戶唯一標(biāo)識(shí),合作方定義(可為字母、數(shù)字、下劃線或其組合)
sign 簽名 String 32 必須在服務(wù)器端生成 生成方法
atime 簽名時(shí)間戳 Long 64 當(dāng)前UNIX TIMESTAMP簽名時(shí)間戳 (如:137322417)
status 問(wèn)題狀態(tài) String create
ask 用戶發(fā)送的首問(wèn) String
is_todoc 是否是定向問(wèn)題 Bool
is_paid_clinic 是否是普通眾包 Bool
upgrade_type 付費(fèi)升級(jí)類型 String 僅眾包升級(jí)類型問(wèn)題有值 二甲醫(yī)生: qc_hospital_common 三甲醫(yī)生: qc_hospital_upgrade

返回:

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

常見(jiàn)錯(cuò)誤碼

錯(cuò)誤碼 錯(cuò)誤信息 說(shuō)明
1 default error 未歸類的請(qǐng)求或者處理錯(cuò)誤
10001 invalid partner 第三方賬戶檢查失敗,請(qǐng)確保partner參數(shù)正確
10002 invalid user 第三方賬戶用戶id錯(cuò)誤
10003 invalid username or password 第三方用戶驗(yàn)證失敗,請(qǐng)確保同一用戶每次登錄的賬戶名和密碼一致
10004 invalid param content 問(wèn)題內(nèi)容檢查失敗,請(qǐng)確保問(wèn)題格式符合要求
10005 invalid doctor id 醫(yī)生id無(wú)效
10006 sign verification failed 簽名驗(yàn)證失敗,可以通過(guò)復(fù)現(xiàn)用例簽名來(lái)檢查構(gòu)造sign方法是否正確
10007 atime time out 時(shí)間戳檢查失敗,請(qǐng)確保服務(wù)器時(shí)間已同步標(biāo)準(zhǔn)時(shí)間
10008 Missing param package_name or package_sign package_name或package_sign缺失
10009 Invalid mode(should be either server or client) 無(wú)效模式(應(yīng)該為"client"或者"server")
10010 invalid problem_id 請(qǐng)求參數(shù)中的問(wèn)題id不正確
10011 invalid start_num and count 無(wú)效的start_num或者count,必須是數(shù)字
10012 invalid ask text ask參數(shù)不存在
10013 invalid clinic no 科室號(hào)無(wú)效
10014 問(wèn)題ID錯(cuò)誤 該id對(duì)應(yīng)的問(wèn)題不存在
10015 非提問(wèn)者不能執(zhí)行該操作
10016 用戶不存在,請(qǐng)先注冊(cè) 收到此提示的原因是:該用戶尚未在春雨平臺(tái)注冊(cè),針對(duì)此問(wèn)題,合作方需使用登錄/注冊(cè)接口為該用戶(user_id)創(chuàng)建賬號(hào)并登錄
10017 param content is too long 問(wèn)題或者評(píng)價(jià)內(nèi)容超過(guò)5kB,極有可能是內(nèi)容類型錯(cuò)誤引起
10018 invalid atime atime 錯(cuò)誤
10020 param "xx" check err 參數(shù)校驗(yàn)錯(cuò)誤
10101 content 類型需要為 text,image,audio,patient_meta 中任意一種
10102 缺少 text 字段內(nèi)容
10103 缺少 file 字段內(nèi)容
10104 缺少 age 和 sex 字段內(nèi)容
10201 對(duì)不起,您不能提交問(wèn)題。
10202 不能提問(wèn)非醫(yī)療問(wèn)題
10203 您已提問(wèn)成功,無(wú)需重復(fù)提問(wèn)
10301 問(wèn)題已經(jīng)被關(guān)閉/刪除,不能追問(wèn)
10401 invalid star
10402 您已經(jīng)進(jìn)行過(guò)評(píng)價(jià),不能再次評(píng)價(jià)! 收到此提示的原因是:已對(duì)該問(wèn)題做過(guò)評(píng)價(jià)
10403 您現(xiàn)在還不能對(duì)該問(wèn)題進(jìn)行評(píng)價(jià)! 評(píng)價(jià)接口調(diào)用規(guī)則:?jiǎn)栴}交互3次以后可以評(píng)價(jià),低于3次需等問(wèn)題關(guān)閉后才可評(píng)價(jià)
10404 問(wèn)題無(wú)醫(yī)生認(rèn)領(lǐng)回答,不能評(píng)價(jià) 評(píng)價(jià)接口調(diào)用規(guī)則:?jiǎn)栴}交互3次以后可以評(píng)價(jià),低于3次需等問(wèn)題關(guān)閉后才可評(píng)價(jià)
10501 close problem failed 問(wèn)題關(guān)閉錯(cuò)誤,問(wèn)題只能在有醫(yī)生領(lǐng)取并回答的情況下才能執(zhí)行關(guān)閉操作。
10601 非問(wèn)題創(chuàng)建者不能退款
10602 問(wèn)題已經(jīng)被醫(yī)生回復(fù),不可以執(zhí)行退款操作
10603 當(dāng)前問(wèn)題狀態(tài)不能進(jìn)行該操作
10604 正式環(huán)境轉(zhuǎn)診問(wèn)題不可以退款
10605 退款金額不能為0,請(qǐng)校驗(yàn)退款金額
10606 無(wú)相應(yīng)支付記錄
11001 invalid price 無(wú)效價(jià)格
11002 invalid partner_order_id 無(wú)效的partner訂單id
11003 duplicate partner_order_id 重復(fù)的partner訂單id
11004 invalid chunyu_order_id 無(wú)效的chunyu_order_id
11005 order does not exist 訂單不存在
11006 closed record 已關(guān)閉的記錄
11007 create payment order failed 創(chuàng)建支付訂單失敗
11008 not the order's owner 不是訂單創(chuàng)建者
11009 paid is not equal to price 支付金額與價(jià)格不相符
11012 invalid logistics_info format 無(wú)效的物流信息格式
11013 購(gòu)買失敗
11014 您已被加入黑名單, 不能購(gòu)買任何服務(wù)
12001 醫(yī)生不存在
12002 醫(yī)生未回答的問(wèn)題數(shù)過(guò)多
12003 因違背提問(wèn)規(guī)則,此功能暫不可用。如有疑問(wèn)請(qǐng)聯(lián)系春雨在線客服 收到此提示的原因是:提問(wèn)用戶已被加入黑名單,無(wú)法發(fā)起提問(wèn)。黑名單相關(guān)邏輯,請(qǐng)參考“黑名單邏輯”章節(jié)。
12004 首問(wèn)字?jǐn)?shù)過(guò)少 圖文咨詢首問(wèn)字?jǐn)?shù)不得少于10個(gè)字
13001 醫(yī)生24小時(shí)內(nèi)無(wú)法預(yù)約
14001 訂單創(chuàng)建失敗

系統(tǒng)文案

API接入合作方可考慮自行增加以下系統(tǒng)消息邏輯以優(yōu)化用戶體驗(yàn)

問(wèn)題類型 條件 系統(tǒng)消息文案
定向問(wèn)題 1、白天付費(fèi)問(wèn)題(6:00-22:59:59)
2、患者首問(wèn)自動(dòng)觸發(fā)
已為您通知到XXX醫(yī)生,請(qǐng)耐心等待。
您也可以補(bǔ)充更多病情描述,以獲得更充分的幫助。
1、白天付費(fèi)問(wèn)題(6:00-22:59:59)
2、患者首問(wèn)10分鐘后醫(yī)生未回復(fù)自動(dòng)觸發(fā)
您的焦慮心情我們非常理解,但XXX醫(yī)生當(dāng)前忙碌,無(wú)法立即回復(fù),請(qǐng)多體諒。
醫(yī)生回復(fù)后,您將在第一時(shí)間收到通知。
1、夜晚付費(fèi)問(wèn)題(23:00—次日5:59:59)
2、夜晚患者首問(wèn)自動(dòng)觸發(fā)
親愛(ài)的,您好:
我們已將您的問(wèn)題發(fā)送給xxx醫(yī)生,但夜深人靜,醫(yī)生也要休息一下,請(qǐng)您白天再來(lái)查看醫(yī)生的回復(fù),不要著急哦!
眾包付費(fèi) 患者首問(wèn)10分鐘后醫(yī)生未回復(fù)自動(dòng)觸發(fā) 親愛(ài)的,您好:
我們已通知醫(yī)生。為您答題的醫(yī)生均在醫(yī)院臨床一線工作,無(wú)法做到隨問(wèn)隨答,請(qǐng)您耐心等待哦! 您的問(wèn)題得到回復(fù)后,我們會(huì)在第一時(shí)間給您推送消息~