## 后端通信 * 詳細內容請查看 接口文檔 000 前端開發必讀 * 后臺接口地址 PC [http://dykf.dingyinkj.com/rayds/doc.html#/home]() * 后臺接口地址 APP [http://test.hyzn0755.com/rayds/doc.html#/home]() * [ ] http狀態 返回碼 ``` * 11 ==> 令牌過期 * 12 ==> 沒找到令牌 * 13 ==> 令牌解析錯誤 * 14 ==> 令牌無效 * 21 ==> 賬號已過期 * 22 ==> 賬號已禁用 * 23 ==> 賬號被踢出 * 24 ==> 賬號已刪除 * 81 ==> 驗證碼過期 * 82 ==> 驗證碼錯誤 * 99 ==> 服務未就緒 * 100 ==> 當前賬號無權限 * 200 ==> 正常(成功) * 201 ==> 未歸類業務異常 * 400 ==> 系統錯誤 * 901 ==> 非法的訪問請求 * 902 ==> 過期的訪問請求 * 903 ==> 訪問請求被限流 * 904 ==> 訪問請求未授權 ``` * [ ] 獲取數據接口 1. 如果接口中有分頁對象,默認是pageobject屬性中存放; 2. 如果接口中有普通列表,默認是listobject屬性中存放; 3. 默認所有獲取數據的接口里面,都包含了當前登陸的屬性,存放在curLoginData屬性中; 4. 如果接口中,有需要為特定數據結構指定的列表,默認是entityConvertedList屬性中; 5. 當前列表中數據,如果其中有需要翻譯的數據項,那么,命名統一為原名稱+Translated,比如,domainId為原字段,翻譯后為domainIdTranslated; * [ ] 接口安全機制 1. 前端需先從后端獲取合法授權的appId(固定12位)和appSecret作為基準參數,這兩個參數需要存到前端本地,必須考慮到因為安全因素,修改appSecret; 2. 所有的接口請求,除接口定義的參數外,額外的,必須(無論GET/POST)附加以下兩個參數:raySignature和rayTimeStamp,這兩個參數取值的算法如下所述; 3. rayTimeStamp取當前請求的時刻,格式為yyyyMMddHHmmss(14位,如20210303125959); 4. raySignature取appId+md5(md5(rayTimeStamp)+appSecret),中間那個"+"僅表示兩段字符相連,組合的結果并不包括該符號本身; 5. 需要注意的是,接口請求后,后端既校驗合法性,也會校驗時效性,前端編程需要注意; 請求接口不論get/post 都要帶上