2014-04-20 二手交易平臺接口文檔

平臺接口文檔v.0.2

 

通過一段時間的開發和研究，二手交易平臺的模塊已經有初步架構的造成，原有不合理的內容進行了修改和調整

 

架構的說明以下：

架構：

    Onethink爲應用層框架，ThinkPHP爲底層PHP框架，數據庫採用Mysql，部分數據採用SAE的KVDB分佈式KEY-VALUE數據庫存儲，Memcached主要用來保存用戶的登錄狀態，由於比較費豆子，因此緩存的使用還須要考慮

 

1、登錄註冊模塊

註冊：接口與登陸相似，前期能夠採用網站前臺註冊的方法

 

登錄：考慮到對服務器性能的考慮和客戶端發起請求的便利性，對於APP端的登錄模塊，單獨開發了專用APP的用戶接口

服務端Memcache鍵值對保存加密的密鑰，加密步驟爲sort    ->    編碼    ->    sha1的步驟(仿照原有的方式)， 鍵名爲    username_user_auth_sign

APP端採用Cookie的模式，存儲一段包含用戶名,uid，登陸時間，登錄IP的緩存，APP端無須解析

 

 

登錄接口的框架與onethink底層的Member模型完成對接，接口以下所敘述：

 

1.登錄接口

http://sechand.sinaapp.com/index.php/Home/Api/app_login

 

參數：username,password

請求類型：post

 

返回格式

{"ret_code":"2","message":"Success"}

 

部分ret_code返回碼說明：

請求成功：返回碼ret_code爲正，即用戶的uid

請求失敗：

    -1:系統級別禁用，好比說用戶不存在之類的

    -2:密碼錯誤

    -3:管理員操做的用戶禁止

    其餘負數:調試階段的錯誤代碼

 

2.登出接口

http://sechand.sinaapp.com/index.php?s=/Home/Api/app_logout

 

參數：無

請求類型：POST

 

返回格式：

{"ret_code":-2}

ret_code返回碼說明：

請求成功：正數爲用戶的uid

請求失敗：

    -1:刪除Memcache失敗

    -2:已經處於未登陸的狀態

 

3.用於檢測Cookie的接口

http://sechand.sinaapp.com/index.php/Home/Api/needLogin

 

參數：無

請求類型：POST

返回示例：

成功：

{"ret_code":0,"message":"You can get the data"}

失敗：

{"ret_code":-1,"message":"Login First"}

來自爲知筆記(Wiz)