1、.七樂康患者端接口文檔版本號：V2.6.0文檔編號：功能模塊負(fù)責(zé)人相關(guān)接口備注患者APP咨詢記錄接口高亮亮3.2.9 患者咨詢記錄APP咨詢記錄接口由原IM服務(wù)接口切換為該接口，響應(yīng)添加醫(yī)生相關(guān)信息節(jié)點(diǎn)。請求參數(shù)不變。目錄1.引言32.接口規(guī)范31.1.協(xié)議31.2.地址31.3.公共參數(shù)31.4.返回值33.接口詳細(xì)說明43.1.首頁&啟動43.1.1.首頁43.1.2.啟動信息53.2.個人中心63.2.1.獲取個人中心信息（側(cè)邊欄基本信息）63.2.2.余額詳情73.2.3.積分列表73.2.4.優(yōu)惠券列表83.2.5.意見反饋83.2.6.push消息推送93.2.7.推薦列表

2、93.2.8.獲取患者是否初復(fù)診113.3.視頻預(yù)約113.3.1.提交視頻預(yù)約113.3.2.預(yù)約成功123.3.3.我的預(yù)約133.3.4.預(yù)約詳情153.3.5.取消預(yù)約163.4.注冊登錄173.4.1.獲取appID173.4.2.微信登錄183.4.3.獲取驗(yàn)證碼183.4.4.綁定手機(jī)號193.4.5.是否顯示登錄輸入框203.5.找醫(yī)生203.5.1.預(yù)約醫(yī)生（視頻預(yù)約）203.5.2.查找醫(yī)生223.5.3.找醫(yī)生-加載醫(yī)生一周可預(yù)約時間234.關(guān)于異常狀態(tài)碼定義的建議251. 引言本文檔用于描述微藥店服務(wù)接口規(guī)范(不涉及用戶購買流程)，主要包括：網(wǎng)絡(luò)傳輸協(xié)議、數(shù)據(jù)傳輸協(xié)議,

3、參數(shù)及返回值說明等內(nèi)容。2. 接口規(guī)范1.1. 協(xié)議接口基于HTTP協(xié)議，支持GET/POST請求，以JSON格式返回數(shù)據(jù)。1.2. 地址接口地址為(開發(fā))：http:/ap.7lk.me接口地址為(正式)：1.3. 公共參數(shù)參數(shù)名參數(shù)含義必選取值_p平臺（預(yù)留區(qū)分手機(jī)、平板）Y0：android_手機(jī)1：ios_手機(jī)2：PC平臺_o應(yīng)用來源Y0：患者App 1：醫(yī)生App2：患者微信3：互聯(lián)網(wǎng)醫(yī)院（PC）_n是否原生Y0：非原生（H5）1：原生_v版本號Y格式：x.x.x 例如：1.0.0_nv版本號（非原生H5）N格式：x.x.x 例如：1.0.0_m設(shè)備型號N例如：iphone5S_cJ

4、SONP的回調(diào)函數(shù)名NAjax調(diào)用使用，原生頁面不傳說明：如上參數(shù)為公共參數(shù)，請在Http Header中傳遞1.4. 返回值返回值的基本結(jié)構(gòu)如下："code":"", "msg":"", "data":,返回值結(jié)構(gòu)描述屬性含義取值code本次請求狀態(tài)碼0：表示成功；其他數(shù)字表示異常。msg狀態(tài)碼對應(yīng)的信息狀態(tài)碼對應(yīng)的提示信息。data業(yè)務(wù)相關(guān)數(shù)據(jù)JSON數(shù)組。不同接口返回的JSON數(shù)據(jù)對象3. 接口詳細(xì)說明3.1. 首頁&啟動3.1.1. 首頁描述首頁地址/index參數(shù)參數(shù)名類型必須

5、備注patientId字符Y醫(yī)生ID號token字符Y校驗(yàn)登陸方法GET/POST響應(yīng)成功"code": 0,"msg": "成功","data": "infos": "name":"黃安","title":"醫(yī)師","backgroundImg": "http:/yun.7lk.me/dri/photo/8466/1467192946773.png", "depar

6、tmentName": "眼科"，"fuzzyImg": "http:/yun.7lk.me/dri/photo/8466/1467192946773.png" ,"prsonal": 0,"firstDoctorId": 166 姓名級別頭像地址科室名稱模糊圖片是否有私有醫(yī)生（0：無，1：有）第一個綁定的醫(yī)生Id失敗code的值不為0的時候備注3.1.2. 啟動信息描述啟動信息地址/initData參數(shù)參數(shù)名類型必須備注方法GET/POST響應(yīng)成功"code":

7、0,"msg": "成功","data": "limitValue": "revacation": "max": 0,"min": 10 ,"customerServPhone": "quot;,"serverTime": "09:00-18:00","cancelDetailList": "reason": "

8、我想改約其他時間。","code": 1026 ，"service": "type": 4,"name": "視頻預(yù)約" 限制值信息預(yù)約描述限制客服電話客服服務(wù)時間取消預(yù)約描述信息取消信息取消碼服務(wù)類型服務(wù)名稱失敗code的值不為0的時候備注3.2. 個人中心3.2.1. 獲取個人中心信息（側(cè)邊欄基本信息）描述患者個人基本資料信息地址/patient/simpleInfo參數(shù)參數(shù)名類型必須備注patientId數(shù)字Y患者idtoken字符串Y加密串方法GET/POST響應(yīng)成功"

9、;code": 0,"msg": "success","data": "name": "莉莉","photo": ""age": 20,"gender": "女","phone":123245647675,"balance":100,"pointNum":100010,"couponNum":1000 返回狀態(tài)提示信息

10、姓名頭像年齡性別手機(jī)號余額積分優(yōu)惠券失敗code的值不為0的時候，請直接顯示msg的值備注3.2.2. 余額詳情3.2.3. 積分列表描述個人中心查看積分歷史地址/patient/balance參數(shù)參數(shù)名類型必須備注patientId數(shù)字Y患者idpage數(shù)字Y頁數(shù)num數(shù)字Y每頁條數(shù)（默認(rèn)10）token字符串Y密鑰方法POST響應(yīng)成功"code": 0,"msg": "成功","data": "pageNo": 1,"pageSize": 10,"orderBy

11、": null,"order": null,"result": "totalBalance": 200,"date": "2015-12-12 11:11:11","name": "購藥積分","num": 100 ,"totalCount": 2,"first": 0,"orderBySetted": false,"totalPages": 1,

12、"hasNext": false,"nextPage": 1,"hasPre": false,"prePage": 1 返回狀態(tài)提示信息總積分積分時間積分名稱積分?jǐn)?shù)量記錄總數(shù)失敗code的值不為0的時候，請直接顯示msg的值備注3.2.4. 優(yōu)惠券列表參見b2c接口文檔3.2.5. 意見反饋描述記錄用戶意見地址/patient/coupon參數(shù)參數(shù)名類型必須備注patientId數(shù)字Y患者idunionKey字符串N密鑰（微信端必傳）token字符串NAPP端必傳suggestion字符串Y意見內(nèi)容phone數(shù)字N

13、手機(jī)號方法POST響應(yīng)成功"code": ，"msg": "success","data": 返回狀態(tài)提示信息失敗code的值不為0的時候，請直接顯示msg的值備注3.2.6. push消息推送描述push消息發(fā)送地址/push/send參數(shù)參數(shù)名類型必須備注patientIdLongY患者idmessageStringY消息內(nèi)容typeIntegerY消息類型(待定)方法POST響應(yīng)成功"code": ，"msg": "success","da

14、ta": 返回狀態(tài)提示信息失敗code的值不為0的時候，請直接顯示msg的值備注3.2.7. 推薦列表描述推薦列表地址/patient/doctor/recommend參數(shù)參數(shù)名類型必須備注patientId數(shù)字Y患者iddoctorId數(shù)字Y醫(yī)生IDpage數(shù)字Y頁數(shù)num數(shù)字Y每頁條數(shù)（默認(rèn)10）token字符串Y密鑰方法POST響應(yīng)成功"code": 0,"msg": "成功","data": "pageNo": 1,"pageSize": 10,"

15、orderBy": null,"order": null,"result": "id": 1,"doctorName": "杜松","createdAt": "2016-07-21 14:44:21","detail": "id": 1,"name": "三黃片","commonName": "這是啥","quanti

16、ty": 100,"usages": "一天一頓","bakup": "備注" ,"totalCount": 2,"first": 0,"orderBySetted": false,"totalPages": 1,"hasNext": false,"nextPage": 1,"hasPre": false,"prePage": 1 返回狀態(tài)提示信息

17、推薦ID醫(yī)生名稱推薦時間推薦商品列表推薦商品詳情ID商品名通用名商品數(shù)量用法用量備注失敗code的值不為0的時候，請直接顯示msg的值備注3.2.8. 獲取患者是否初復(fù)診描述推薦列表地址/patient/doctor/firstisit參數(shù)參數(shù)名類型必須備注patientId數(shù)字Y患者iddoctorId數(shù)字Y醫(yī)生IDtoken字符串Y密鑰方法POST響應(yīng)成功"code": 0,"msg": "成功","data": "firstisit": 1 返回狀態(tài)提示信息初診復(fù)診 0 初診 1 復(fù)診失敗

18、code的值不為0的時候，請直接顯示msg的值備注3.2.9. 咨詢記錄患者APP咨詢記錄接口，調(diào)整接口調(diào)用。返回數(shù)據(jù)添加醫(yī)生相關(guān)數(shù)據(jù)返回描述患者咨詢記錄地址/patient/consultList參數(shù)參數(shù)名類型必須備注tokenStringYApp端tokenpatientIdLongY患者IddoctorIdLongN醫(yī)生Id（為空時查詢所有會話；不為空則查詢當(dāng)前醫(yī)生會話）statusIntY1:未完成的會話;2全部的會話pageNoIntY頁碼 默認(rèn)1pageSizeIntY每頁記錄數(shù) 默認(rèn)20orderByStringN排序條件 0：升序 1：降序 默認(rèn)升序方法POST響應(yīng)成功

19、0;   "code":0,    "msg":"成功",    "data":                    "result":    &#

20、160;                               "name":"測試醫(yī)生名稱",            &#

21、160;       "headUrl":"xxx.jpg",                    "department":"XXX科室",         

22、;           "hospital":"xxx醫(yī)院",                    "status":1,         

23、;           "sessionId":"12_12_123123",                    "fromId":1,       

24、60;            "toId":2,                    "beginTime":1434940653737,        &#

25、160;           "endTime":1434940653737,                    "relation":1,         

26、;           "payType":1,                    "payStatus":1,           &

27、#160;        "price":30,                    "containVideo":1,             &

28、#160;      "containRecom":1,                    "viewMsg":               &#

29、160;        "type":2,                        "content":"adfasdfasdf"       

30、                                         ,         

31、;   "pageNo":1,            "pageSize":1,            "totalCount":18,           &

32、#160;"totalPages":2            醫(yī)生名稱頭像科室醫(yī)院認(rèn)證狀態(tài)會話ID發(fā)送者接收者開始時間結(jié)束時間（結(jié)束時間為空則未結(jié)束）發(fā)起人:1醫(yī)生,0患者是否收費(fèi):0免費(fèi),1付費(fèi)會話狀態(tài):-1咨詢中0:未支付1:已支付 會話價格包含視頻咨詢:0否，1是包含推薦購藥：0否,1：是顯示消息內(nèi)容消息類型（見備注）消息內(nèi)容（根據(jù)類型區(qū)分）失敗消息類型：1 ：文本消息；2 ：圖片消息；4 ：音頻消息；8 ：視頻消息；16：藥方消息；32：鏈接消息；

33、64：購藥咨詢; 128:在線視頻消息；備注3.3. 視頻預(yù)約3.3.1. 提交視頻預(yù)約描述提交視頻預(yù)約地址/patient/reserve參數(shù)參數(shù)名類型必須備注patientId數(shù)字Y患者標(biāo)識deviceInfo字符Y手機(jī)設(shè)備號（2rffsdfS2r2333）doctorId數(shù)字Y醫(yī)生ID號startAt數(shù)字Y預(yù)約時間（毫秒）gender數(shù)字Y性別（0：女，1：男）content字符Y咨詢內(nèi)容age數(shù)字Y年齡files文件流N上傳圖片(文件列表)token字符Y校驗(yàn)登陸方法GET/POST響應(yīng)成功"code": 0,"msg": "成功&qu

34、ot;,"data": "orderSn": "V00132016072200001" 請求狀態(tài)提示信息訂單號失敗code的值不為0的時候備注3.3.2. 預(yù)約成功描述預(yù)約成功地址/patient/reservationInfo參數(shù)參數(shù)名類型必須備注patientId數(shù)字Y患者標(biāo)識orderSn字符Y訂單號token字符Y校驗(yàn)登陸方法GET/POST響應(yīng)"code": 0,"msg": "成功","data": "orderSn": &

35、quot;12121333232323","status": 1,"startAt": "2016-6-15 12:30-13:00","remindInfo": "一小時后","name": "dd","headUrl": "/dd/wd/gf.jpg","title":"醫(yī)師", ,"hospitalName": "廣東省人民醫(yī)院&q

36、uot;,"departmentName": "眼科"，"authStatus": 1"doctorId": 11221 訂單號狀態(tài)（1：待付款，2：待咨詢，3：已取消，4：已結(jié)束）預(yù)約時間預(yù)約提醒醫(yī)生姓名頭像級別醫(yī)院名稱科室名稱醫(yī)生認(rèn)證狀態(tài)（0：未認(rèn)證，1：已認(rèn)證）醫(yī)生ID號失敗code的值不為0的時候備注3.3.3. 我的預(yù)約描述我的預(yù)約地址/patient/reservationList參數(shù)參數(shù)名類型必須備注patientId數(shù)字Y患者標(biāo)識status數(shù)字N狀態(tài)（1：待付款，2：待咨詢，3：已取消，4：已結(jié)束

37、）page數(shù)字N頁碼，默認(rèn)1num數(shù)字N每頁數(shù)量，默認(rèn)10token字符Y校驗(yàn)登陸方法GET/POST響應(yīng)"code": 0,"msg": "成功","data": "pageNo": 1,"pageSize": 1,"orderBy": null,"order": null,"result": "reservationId": 14,"orderSn": "V001

38、22016072500003","status": 1,"startAt": "37191-01-21 19:20-19:50","period": 0,"charge": 0,"name": "王騰飛","headUrl": "http:/yun.7lk.me/dri/photo/8644/1468287184583.jpg","content": "222321313132

39、32423432","detailType": 1，"authStatus": 1，"detail":"超過15分鐘未付款自動取消" ，"doctorId": 11221，"payStatus": 0，"cancelStatus": 0 ,"totalCount": 12,"first": 0,"prePage": 1,"nextPage": 2,"hasP

40、re": false,"hasNext": true,"totalPages": 12,"orderBySetted": false id號訂單號狀態(tài)（1：待付款，2：待咨詢，3：已取消，4：已結(jié)束）預(yù)約時間預(yù)約時長(毫秒)預(yù)約費(fèi)用（分）醫(yī)生姓名頭像癥狀描述描述類型（1：等待付款，2：等待醫(yī)生發(fā)起視頻咨詢，3：您取消了本次預(yù)約，4：醫(yī)生取消了本次預(yù)約，5：您超時未完成支付，6：醫(yī)生取消了本次預(yù)約(醫(yī)生超時未發(fā)起)，7：患者取消了本次預(yù)約(患者超時未接受)，8：已結(jié)束）醫(yī)生認(rèn)證狀態(tài)（0：未認(rèn)證，1：已認(rèn)證）詳情醫(yī)生ID是否可支

41、付（0：否，1：是）是否可取消（0：否，1：是）失敗code的值不為0的時候備注3.3.4. 預(yù)約詳情描述預(yù)約詳情地址/patient/reservationInfo參數(shù)參數(shù)名類型必須備注patientId數(shù)字Y患者id號orderSn字符Y訂單號token字符Y校驗(yàn)登陸方法GET/POST響應(yīng)"code": 0,"msg": "成功","data": "reservationId": 14,"orderSn": "V00122016072500003",

42、"status": 1,"startAt": "37191-01-21 19:20-19:50","period": 0,"charge": 0,"name": "王騰飛","headUrl": "http:/yun.7lk.me/dri/photo/8644/1468287184583.jpg","title": "住院醫(yī)師","hospitalName"

43、: "北京協(xié)和醫(yī)院","departmentName": "移動科室","remindInfo": "15時38分21秒","content": "22232131313232423432","fileUrls": ,"gender": 1,"age": 22,"detailType": 1,"detail":"超過15分鐘未付款自動取消"

44、; ,"authStatus": 1,"doctorId": 11221"payStatus": 0，"cancelStatus": 0， id號訂單號狀態(tài)（1：待付款，2：待咨詢，3：已取消，4：已結(jié)束）預(yù)約時間預(yù)約時長(毫秒)預(yù)約費(fèi)用（分）醫(yī)生姓名頭像級別醫(yī)院名稱科室名稱預(yù)約提醒癥狀描述文件列表年齡性別（0：男，1：女）描述類型（1：等待付款，2：等待醫(yī)生發(fā)起視頻咨詢，3：您取消了本次預(yù)約，4：醫(yī)生取消了本次預(yù)約，5：您超時未完成支付，6：醫(yī)生取消了本次預(yù)約(醫(yī)生超時未發(fā)起)，7：患者取消了本次預(yù)約(患者超時未

45、接受)，8：已結(jié)束）詳情醫(yī)生認(rèn)證狀態(tài)（0：未認(rèn)證，1：已認(rèn)證）醫(yī)生id是否可支付（0：否，1：是）是否可取消（0：否，1：是）失敗code的值不為0的時候備注3.3.5. 取消預(yù)約描述取消預(yù)約地址/patient/cancelReservation參數(shù)參數(shù)名類型必須備注patientId數(shù)字Y患者標(biāo)識reservationId數(shù)字Y預(yù)約id號detail字符Y取消描述detailCode數(shù)字Y取消碼token字符Y校驗(yàn)登陸方法GET/POST響應(yīng)成功"code": 0,"msg": "成功","data": 失敗c

46、ode的值不為0的時候備注備注3.4. 注冊登錄3.4.1. 獲取appID描述獲取微信登錄應(yīng)用appId地址/wxLogin/getAppId參數(shù)參數(shù)名類型必須備注方法GET/POST響應(yīng)成功"code": 0,"msg": "成功","data": "appId": "215315" 失敗code的值不為0的時候備注獲取微信app授權(quán)id。3.4.2. 微信登錄描述微信登錄授權(quán)請求地址/wxLogin/login參數(shù)參數(shù)名類型必須備注accessCodeStringY微信

47、返回授權(quán)碼方法GET/POST響應(yīng)成功"code": 0,"msg": "成功","data": "patientId": "215315","token": "215315","qlkId "："22232 "，"bindPhone"："1 "， 患者id患者token七樂康id是否綁定手機(jī)號：1綁定，0未綁定失敗code的值不為0的時候備注1. 該接口返

48、回code碼為40036時，表示用戶獲取的授權(quán)碼不正常,或者已經(jīng)過期，需要客戶端進(jìn)行重新讓用戶進(jìn)行授權(quán)，使用新的授權(quán)碼進(jìn)行登陸。2. 該接口返回code碼為40037時，表示獲取用戶的微信信息失敗,需要客戶端進(jìn)行重新讓用戶進(jìn)行授權(quán)，使用新的授權(quán)碼進(jìn)行登陸。3. 當(dāng)?shù)顷懗晒Ψ祷赜脩粑唇壎ㄊ謾C(jī)號時,需要客戶端調(diào)用3.4.3進(jìn)行獲取驗(yàn)證碼。綁定手機(jī)號使用的actionType=0，即資料完善,增加手機(jī)號。3.4.3. 獲取驗(yàn)證碼描述用戶在注冊或忘記密碼時需要發(fā)送手機(jī)驗(yàn)證碼進(jìn)行認(rèn)證，調(diào)此接口進(jìn)行驗(yàn)證碼下發(fā)(注：發(fā)送失敗情況可能存在示例情況：今日發(fā)送量已達(dá)上限/運(yùn)營商業(yè)務(wù)繁忙等)。地址/sms/send

49、參數(shù)參數(shù)名類型必須備注phoneNumY用戶輸入手機(jī)號碼actionTypeY0:資料完善，新增手機(jī)號；1：修改手機(jī)號方法GET/POST響應(yīng)成功"code": 0,"msg": "成功","data": 失敗code的值不為0的時候備注3.4.4. 綁定手機(jī)號描述微信登錄綁定手機(jī)號地址/patient/bindPhone參數(shù)參數(shù)名類型必須備注patientIdStringY患者idtokenStringY患者tokenphoneNumStringY手機(jī)號verifyCodeStringY驗(yàn)證碼方法GET/POST

50、響應(yīng)成功"code": 0,"msg": "成功","data": "patientId": "215315","token": ""，"qlkId "："22232 "， 患者id訪問key七樂康id失敗code的值不為0的時候備注3.4.5. 是否顯示登錄輸入框描述Iphone客戶端是否顯示登錄框(此接口僅用于驗(yàn)證iphone客戶端)地址/inputBox/displayOrNotHeader

51、 參數(shù)參數(shù)名類型必須備注_pStringY客戶端平臺_vStringY客戶端版本號_oStringY來源_nStringY是否原生方法GET/POST響應(yīng)成功"code": 0,"msg": "成功","data": "result": 0 result:0 顯示輸入框1 不顯示輸入框失敗code的值不為0的時候，請直接顯示msg的值備注1.校驗(yàn)iphone平臺版本,確認(rèn)是否顯示登錄輸入框,微信/android平臺無需檢查2.當(dāng)服務(wù)端返回result=0時，客戶端顯示登錄輸入框3.當(dāng)服務(wù)端返回r

52、esult=1時，客戶端不顯示登錄輸入框4.軟件版本格式：x.x.x 例如：1.0.05.版本對比方法:獲取iphone客戶端軟件版本,從服務(wù)器端redis中獲取軟件版本,客戶端軟件版本與服務(wù)器端軟件版本對比,確認(rèn)iphone客戶端軟件是否顯示登錄輸入框.3.5. 找醫(yī)生3.5.1. 預(yù)約醫(yī)生（視頻預(yù)約）描述可以視頻預(yù)約的醫(yī)生地址/search/reserveList參數(shù)參數(shù)名類型必須備注patientIdLongY用戶id(患者id)tokenStringY加密字符串reserveTimeStringY預(yù)約時間cityIdIntegerN城市市iddepartIdIntegerN二級科室Id

53、servingTypeIntegerN服務(wù)類型 0-全部 1-圖文咨詢 2-語音（預(yù)留）4-視頻pageIntegerN頁數(shù)，默認(rèn)1numIntegerN每頁條數(shù)，默認(rèn)10方法GET/POST響應(yīng)成功 "code": 0, "msg": "成功", "data": "defaultReq": "cityId": 79, "departId": 1 , "doctorList": "pageNo": 1, "

54、pageSize": 10, "orderBy": null, "order": null, "result": "doctorId": 50, "doctorName": "Dr.", "headerImageUrl": "http:/xx.jpg", "title": "主任醫(yī)師", "hospital": "南方醫(yī)院", "expe

55、rtise": "確認(rèn)修改信息了啊", "payMessage": "99元/次/15分鐘", "canReserve": 0 , , "totalCount": 0, "first": 0, "hasNext": false, "prePage": 1, "nextPage": 1, "hasPre": false, "orderBySetted": false,

56、"totalPages": 0 結(jié)果碼：0成功；非0失敗消息提示：success默認(rèn)條件二級城市id二級科室id當(dāng)前頁數(shù)每頁展示訂單數(shù)醫(yī)生ID醫(yī)生姓名醫(yī)生頭像職稱醫(yī)院擅長付費(fèi)說明能否預(yù)約視頻0-能1-不能結(jié)果總數(shù)總頁數(shù)是否有下一頁下一頁頁碼是否有上一頁上一頁頁碼失敗code的值不為0的時候，請直接顯示msg的值備注3.5.2. 查找醫(yī)生描述患者端根據(jù)名字搜索醫(yī)生地址/search/list參數(shù)參數(shù)名類型必須備注patientIdLongY用戶id(患者id)tokenStringY用戶keykeywordStringN搜索關(guān)鍵字（醫(yī)生姓名）cityIdIntegerN城市市

57、id（默認(rèn)廣州市id）departIdIntegerN二級科室Id如果沒選二級科室傳一級科室idservingTypeIntegerN服務(wù)類型 0-全部 1-圖文咨詢 2-語音（預(yù)留）4-視頻pageIntegerN頁數(shù)，默認(rèn)1numIntegerN每頁條數(shù)，默認(rèn)10方法GET/POST響應(yīng)成功 "code": 0, "msg": "成功", "data": "defaultReq": "cityId": 6, "departId": 1, , "doctorList": "page