資源描述：
《app開發(fā)規(guī)范方案—app接口開發(fā)規(guī)范方案文檔v1.0》由會員上傳分享，免費在線閱讀，更多相關內容在工程資料-天天文庫。
1、WORD文檔可編輯{北京天晴APP接口規(guī)范文檔}手機客戶端接口文檔文件狀態(tài)：[]草稿[√]正式發(fā)布[]正在修改文件標識：當前版本：1.0作者：北京天晴完成日期：技術資料專業(yè)分享WORD文檔可編輯版本歷史版本/狀態(tài)作者參與者起止日期備注V1.0/草稿韓磊移動小組技術資料專業(yè)分享WORD文檔可編輯目錄一、概述11.1有關接口11.1.1接口是純數(shù)據(jù)的交互11.2接口的分類11.2.1查詢類接口11.2.2操作類接口11.2.3上傳下載類接口11.2.4推送類接口1二、查詢類接口格式規(guī)范12.1獲取單條對象信息12.1.1請求格式1
2、2.1.2參數(shù)說明22.1.3正常返回結果22.2獲取列表對象信息22.2.1請求格式22.2.2參數(shù)說明32.2.3正常返回結果3三、操作類接口43.1新增操作43.1.1接口說明43.1.2參數(shù)說明43.1.3正常返回結果43.1.4錯誤返回列表43.2修改操作53.2.1接口說明53.2.2參數(shù)說明53.2.3正常返回結果53.2.4錯誤返回列表53.3刪除操作53.3.1接口說明53.3.2參數(shù)說明63.3.3正常返回結果63.3.4錯誤返回列表6四、上傳下載類64.1上傳文件64.1.1接口說明64.1.2參數(shù)說明7
3、4.1.3正常返回結果74.1.4錯誤返回列表74.2下載文件74.2.1接口說明7技術資料專業(yè)分享WORD文檔可編輯4.2.2參數(shù)說明74.2.3正常返回結果84.2.4錯誤返回列表8五、推送類接口85.1推送消息85.1.1接口說明85.1.2參數(shù)說明85.1.3正常返回結果85.1.4錯誤返回列表8六、通用返回格式96.1正確返回96.1.1接口說明96.1.2參數(shù)說明96.1.3正常返回結果96.1.4錯誤返回列表96.2錯誤返回96.2.1接口說明96.2.2參數(shù)說明106.2.3正常返回結果106.2.4錯誤返回列
4、表10七、附錄107.1通用錯誤返回列表107.2URL地址信息117.2.1主機地址117.2.2URL列表117.3安全機制117.3.1驗證簽名機制117.4其他117.2.1列表數(shù)據(jù)為空的返回11技術資料專業(yè)分享WORD文檔可編輯一、概述1.1有關接口1.1.1接口是純數(shù)據(jù)的交互APP接口是移動設備和業(yè)務之間進行通信的途徑。實質就是以特定的規(guī)則通過接口直接操作數(shù)據(jù)庫的增刪改查。1.2接口的分類1.2.1查詢類接口查詢類接口是指客戶端傳遞一些參數(shù)，服務端根據(jù)參數(shù)依據(jù)需求，前往數(shù)據(jù)庫查詢需要的結果返回數(shù)據(jù)的一類接口。返回類
5、型一般有兩種。第一種是返回一個對象，第二種是返回一個數(shù)組對象。第一種比如登陸，客戶端把用戶名密碼上傳到接口，服務器返回用戶的個人信息。第二種比如獲取客戶，客戶端把用戶的身份信息上傳到接口，服務器返回此身份下的所有客戶數(shù)組集合。1.2.2操作類接口操作類接口是指，客戶端通過接口進行一些增刪改的操作。比如新增一個客戶，修改客戶信息，或者刪除一個客戶。服務器一般返回執(zhí)行的狀態(tài)，有的需要返回執(zhí)行結果的一些信息，比如新增客戶后，返回客戶的ID。1.2.3上傳下載類接口上傳下載類接口是涉及到文件傳輸?shù)慕涌?。比如上傳頭像，需要上傳圖片到服務
6、器，服務端根據(jù)需求響應保存并返回結果。比如客戶端需要顯示用戶頭像，需要讀取網(wǎng)絡圖片文件，在手機上進行顯示。1.2.4推送類接口除了客戶端主動去請求服務端，獲取需要信息之外。有時候，也存在服務端有消息需要通知客戶端的情況，這時候就是服務端向客戶端發(fā)送消息。這類需求可以通過客戶端短時間類循環(huán)請求解決，也可以通過第三方專業(yè)推送解決。也可以通過自己使用socket或者xmpp等協(xié)議進行開發(fā)。二、查詢類接口格式規(guī)范2.1獲取單條對象信息2.1.1請求格式URL支持格式JOSN技術資料專業(yè)分享WORD文檔可編輯HTTP請求方式POST是否
7、登錄驗證請求數(shù)限制2.1.2參數(shù)說明參數(shù)名必選類型及范圍說明xxxtrueString用戶名2.1.3正常返回結果返回鍵類型返回值說明resultString結果代碼信號ok結果成功，fail結果失敗ResponseObject響應體Key1int響應字段值Key2String響應字段值Key3Object響應字段值可以依然包含對象體Key3_Key1int響應字段值{"result":"ok","Response":{"userName":"Mary","sex":1,"Address":[{"city":"JiNan"},
8、{"county":"LiXia"}]}}2.1.4錯誤返回列表詳見：通用錯誤返回列表技術資料專業(yè)分享WORD文檔可編輯2.2獲取列表對象信息2.2.1請求格式URL支持格式JOSNHTTP請求方式POST是否登錄驗證請求數(shù)限制2.2.2參數(shù)說明參數(shù)名必選類型及范圍說明xxx
