[TOC=2] >[danger] 注意事項 > * 請求地址另外給出 > * 以下接口完整地址： 請求地址/api/login > * 除登錄接口外，調用其他接口需要在請求頭部攜帶 cookie 。 鍵名為登錄接口返回的 session_key 字段。鍵值為登錄接口返回的 session_value ## 登錄 ~~~[api] post:/api/login *string:username=測試#賬號 *string:password=123456#密碼 *string:udid=123456#登錄標識，用于區分登錄的電腦設備，需要每個設備唯一生成，便于區分 <<< <<< success { "code": 0, "data": { "id": 3, "nickname": "測試", "name": "測試", "avatar": "", "gender": "secret", "last_login_time": "2019-05-08 16:13:10", "session_key": "PHPSESSID", "session_value": "pahnbupgqvt0mlt0hh03e7imff" } } <<< explain id // 用戶標識 nickname // 用戶昵稱 name // 用戶姓名 avatar // 頭像地址（暫未使用） gender // 性別（暫未使用） last_login_time // 最近登錄時間 session_key // 登錄狀態，其他接口需要 session_value // 登錄狀態，其他接口需要 <<< error { "code": -1, "msg": "賬戶不存在" } ~~~ >[danger] 密碼需要通過 sha256 之后提交 ## 獲取型號列表 ~~~[api] get:/api/device_info <<< <<< success { "code": 0, "data": { "list": [ { "id": 8, "name": "優家6901-xy電采暖2.0", "code_name": "KD5P601", "sn": "746015", "firmware": [ "http://cn.ikelink.com/w1_fw/user1.2048.new.3V2_9.bin__IKECIN_TASK_KD5P1", "http://cn.ikelink.com/w1_fw/user2.2048.new.3V2_9.bin__IKECIN_TASK_KD5P1" ] }, ] } } <<< explain id // 型號標識 name // 型號名稱 code_name // 項目代號 sn // 序列號開始標識 firmware // 固件地址，沒有則為空 <<< error { "code": -1, "msg": "" } ~~~ ## 獲取最后可用號段 ~~~[api] get:/api/last_sn *int:id=0#上面型號列表的 id <<< <<< success { "code": 0, "data": { "sn": "870100000000" } } <<< explain sn // 可申請的開始序列號 <<< error { "code": -1, "msg": "該選項不存在" } ~~~ ## 發起申請 ~~~[api] post:/api/save *string:sn=870100000000#上面接口返回的 sn *int:num=1#申請數量 *int:device_id=87#獲取最后號段選的 id <<< <<< success { "code": 0, "data": { "start_sn": "870100000033", // 開始號段 "end_sn": "870100000033" // 結束號段 } } <<< explain start_sn // 申請的開始序列號 end_sn // 申請的結束序列號 <<< error { "code": -1, "msg": "最少申請 1 個" } ~~~ ## 固件下載 通過型號列表返回的 firmware 字段內的地址進行下載