競拍相關接口 · 小馬快租說明文檔

>注意：（不關前端測試的事）后臺有個定時執行任務，地址為“index.php/Admin/Index/timingImplement”。主要處理的任務有：判斷當前競拍是否結束， ~~~ 競拍的流程： 1：用戶發布競拍【接口：“發布競拍”】 2：添加完【接口：發布競拍】以后，在后臺“待發布競拍”可以發布競拍。 3：在后臺發布完競拍以后，可以調用【接口：獲取競拍列表】查看競拍列表 4：獲取完【接口：獲取競拍列表】，對某個競拍感興趣可以調用【接口：獲取競拍詳細信息】查看競拍的詳情 5：看過【接口：獲取競拍詳細信息】以后，想競拍該競拍可以調用【接口：競拍】參與競拍該競拍 ~~~ * * * * * ## 發布競拍 +++ post:Api/Auction/addWait/token/用戶TOKEN city_id=所在市區ID【默認為1 深圳】# *title=競拍標題【設計稿沒有，需要設計稿添加上去】# *con_name=委托人姓名 # *con_tel=委托人聯系方式# large_area=最大需求面積【最大需求面積與最小需求面積必填一個】# small_area=最小需求面積【最大需求面積與最小需求面積必填一個】# large_price=最高價格【最高價格與最低價格必填一個】# small_price=最低價格【最高價格與最低價格必填一個】# *company_name=公司名稱 # *industry_id=公司行業ID # settled_time=是否立即入駐 0為立即入駐，為數字的時候表示入駐時間，單位為月。如：3表示3個月入駐默認為0# region=委托區域【數組形式】為空的時候不限制區域# describe=描述# <<< success 返回參數說明： { "data": "", "info": "添加成功", "code": 1000, "state": 1 } <<< error { "data": "", "info": "業主姓名不可為空", "code": 1001, "state": 2 } 可能返回的錯誤：代號錯誤 998 查詢無數據 999 用戶未登錄 1001 輸入的信息有誤（提示數據錯誤原因） +++ ## 獲取用戶上傳的競拍【我發布的競拍】 +++ get: Api/Auction/getUserWait/token/用戶token *state=狀態 1為未成交，2為已成交。默認為1（除了2，其他任何數字都為未成交）# <<< success { "data": [ { "_id": { "$id": "58d8da8d4818d6c9129d70de" }, "title": "222222", "region": [ "123123" ] }, { "_id": { "$id": "58d8da984818d6c9129d70e0" }, "title": "222222", "region": [ "123123" ] } ], "info": "查詢成功", "code": 1000, "state": 1 } <<< error { "data": "", "info": "用戶未登錄", "code": 999, "state": 2 } 可能返回的錯誤：代號錯誤 999 用戶未登錄 996 查詢沒有數據 +++ ## 將競拍狀態設置為已成交【客戶已成交】 +++ get: Api/Auction/complete *auction_id=競拍ID# *state=狀態 1為未成交，2為已成交。默認為1（除了2，其他任何數字都為未成交）# <<< success { "data": "", "info": "修改成功", "code": 1000, "state": 1 } <<< error { "data": "", "info": "用戶未登錄", "code": 999, "state": 2 } 可能返回的錯誤：代號錯誤 999 用戶未登錄 997 缺少必須參數 998 修改失敗 +++ ## 獲取競拍列表【競拍頁面】 +++ get: Api/Auction/getAuctionList <<< success 返回參數說明：正在競拍的不返回“業主電話” 與“業主姓名” 正在競拍的：將返回競拍次數與當前競拍出價 { "data": [ { "_id": { "$id": "58b39cde74e5f0fc9b84140a" }, "title": "2", //競拍標題 "region": [ //區域 "羅湖區" ], "state": 1, //競拍狀態 1為正在競拍 9為系統處理中 "release_time": "00:39:05", //競拍剩余時間 "city": "深圳" //市區 }, ], "info": "查詢成功", "code": 1000, "state": 1 } <<< error { "data": "", "info": "查詢無數據", "code": 996, "state": 2 } 可能返回的錯誤：代號錯誤 996 查詢無數據 +++ ## 獲取競拍詳細信息 +++ get: Api/Auction/getAuctionDateils *auction_id=競拍ID # <<< success 返回參數說明：正在競拍的不返回“業主電話” 與“業主姓名” 正在競拍的：將返回競拍次數與當前競拍出價 { "data": { "_id": { "$id": "58db5baaa81e5aaf29f71ecb" }, "title": " 標題", //標題 "large_area": 22, //最小面積 "small_area": 33, //最大面積 "large_price": 22, //最高需求價格 "small_price": 33, //最低需求價格 "company_name": "讀訂單", //公司名稱 "industry_id": "1", //公司行業ID "settled_time": 1, //是否立即入駐為0時為立即入駐，否則單位為月，如：3表示3個月后入駐 "region": [ //區域 "1" ], "describe": "2", //描述 "release_time": "00:00:00", //競拍剩余時間 "state": 9, //0為未競拍，1為可競拍，2為競拍結束，且有人參與競拍 3為競拍結束，且無人競拍， 4為競拍結束，且有人競拍，但沒交保證金， 5,為待簽署合同。 6已簽署合同 9為系統處理中 "user_info": "", //競拍成功后的用戶詳情 "offer": 233, //當前競拍最高價 "num": 3 //當前競拍次數 "user_auction_state": 1 //判斷當前用戶是否競拍過，0為未競拍 1為已競拍 "user_auction_offer": 322 //獲取當前用戶競拍出價 0為未競拍下面信息是當前用戶競拍成功的才會顯示出來 "con_name": 客戶名稱 //客戶名稱 "con_tel": 15512345678 //客戶電話 }, "info": "查詢成功", "code": 1000, "state": 1 } <<< error { "data": "", "info": "缺少必須參數（ID）", "code": 997, "state": 2 } 可能返回的錯誤：代號錯誤 997 缺少必須參數（ID） 996 未找到該競拍 +++ ## 我參與的競拍 +++ get: Api/Auction/userAuction/token/用戶token *state=狀態 0為未成交，1為已成交(任何數字)。默認為0# <<< success { "data": [ { "_id": { "$id": "58d8da8d4818d6c9129d70de" }, "title": "222222", //標題 "region": [ //區域 "123123" ], "state": 2, //1為正在競拍，2為競拍成功，3為競拍失敗，4為競拍成功但沒交保證金， 9為用戶自己 "offer": "123" //用戶出價 }, { "_id": { "$id": "58d8b3bc4818d6c9129d685b" }, "title": "競拍競拍競拍了！！！", "region": [ "1", "2", "3" ], "state": 2, "offer": 222 } ], "info": "獲取成功", "code": 1000, "state": 1 } <<< error { "data": "", "info": "查詢沒有數據", "code": 996, "state": 2 } 可能返回的錯誤：代號錯誤 996 查詢沒有數據 999 用戶未登錄 +++ ## 獲取當前用戶剩余磚石 +++ get: Api/Auction/userVirtualCurrency/token/用戶token <<< success 返回參數說明： { "data": { "virtual_currency": "199890" //剩余磚石 }, "info": "獲取成功", "code": 1000, "state": 1 } <<< error { "data": "", "info": "用戶未登錄", "code": 999, "state": 2 } 可能返回的錯誤：代號錯誤 999 用戶未登錄 +++ ## 競拍 +++ get: Api/Auction/auction/token/用戶token *auction_id=競拍ID # *offer=出價 # <<< success 返回參數說明： { "data": "", "info": "競拍成功，請等待結果", "code": 1000, "state": 1 } <<< error { "data": "", "info": "競拍失敗，錯誤代碼：998", "code": 998, "state": 2 } 可能返回的錯誤：代號錯誤 996 查無該競拍 998 競拍失敗，錯誤代碼：998 1001 參數有誤 1023 您的磚石不足，請充值 1034 該競拍未處于可競拍狀態 1035 不可競拍自己發布的競拍 +++