PS:需要保存起來的參數:
token : 用戶token
city_id : 市區ID 如:深圳的ID
# 用戶接口說明
用戶接口說明:
步驟:
1:沒有賬號的時候需要先注冊賬號。執行【用戶注冊】前需要獲取驗證碼【公告類接口->發送手機驗證碼】,獲取的驗證碼會發用到用戶手機。獲取到驗證碼后就可以輸入注冊必須的參數。
2:注冊完以后可以登錄【用戶登錄】接口。登錄完以后可以【修改密碼】可以【獲取用戶詳細信息】可以【退出登錄】。
3:如果忘記了密碼,可以使用【找回密碼】接口進行找回密碼
* * * * *
# 房源接口說明
房源部分接口分兩部分。1為上傳戶型,2為查找戶型
**添加戶型說明:**
步驟:
1:執行【“添加戶型時”搜索樓盤得出的列表】獲取盤源的名稱與ID。
2:獲取到盤源ID以后,在執行【根據盤源ID獲取棟座數量與樓層數量】獲取到棟座ID與樓層(樓層返回的是樓層總數,前端需要循環總數讓用戶選擇樓層。可以參考后臺)
3:上傳戶型前需要獲取【公告類接口->常用單位】里面的數據讓用戶去選擇。(可以參考空間家上傳戶型)。
1.獲取“價格單位”【公告類接口->常用單位】
2.獲取“裝修類型”【公告類接口->常用單位】
3.獲取“空間功能”【公告類接口->常用單位】
4.獲取“地面類型”【公告類接口->常用單位】
5.獲取“空間配套”【公告類接口->常用單位】
6.獲取“包含費用”【公告類接口->常用單位】
4:調用上圖圖片接口。上傳戶型必須圖片。并獲取回調回來的圖片地址。(圖片上傳請看圖片上傳部分)
5:輸入上傳戶型是的必須參數進行上傳戶型(戶型的圖片都是調用上傳圖片接口,獲取到上傳圖片回調回來的圖片地址。在和其他信息一起上傳。)
**查找戶型說明**
步驟:
1:執行【“找房源”中的搜索盤源】獲取到盤源的信息
2:取出盤源ID,執行【盤源詳情】接口獲取盤源詳細信息。
注:搜索盤源的時候如果有“最低價格”“最高價格”“最小面積”“最大面積”這些條件,需要傳到該接口。原因為:一個盤源可能有很多個,但是又很多面積與價格不在用戶的搜索范圍
3:獲取盤源詳情以后想看盤源下的戶型可以執行【盤源下的戶型列表】獲取該盤源下的戶型
注:搜索盤源的時候如果有“最低價格”“最高價格”“最小面積”“最大面積”這些條件,需要傳到該接口。原因為:一個盤源可能有很多個,但是又很多面積與價格不在用戶的搜索范圍
4:獲取了戶型列表以后,就可以查看戶型詳情了。執行【獲取戶型詳情】并把戶型ID傳進去,獲取戶型的詳細信息。
5:獲取玩戶型的詳細信息以后,感覺這個戶型不錯,想聯系戶型上傳者可以執行【獲取業主電話】,將返回米糠小號。然后就可以撥打米糠小號進行聯系。
* * * * *
# 圖片上傳
說明:
步驟:
1:執行【上傳圖片接口->OSS簽名參數】接口獲取OSS的簽名及參數
返回的數據說明:
accessid:
host:
policy:
signature
expire
callback
imgName
dir
callbackUrl
2:執行【上傳圖片接口->上傳圖片】上傳圖片。其中上傳的地址為第一不返回的“host”的值。
需要的參數說明:
name: 第一步返回的“imgName”
key: 第一步的“dir”加上“imgName”
policy: 第一步返回的“policy”
OSSAccessKeyId: 第一步返回的“accessid”
success_action_status: 200
callback: 第一步返回的“callback”
signature: 第一步返回的“signature”
file: 需要上傳的圖片文件(文件類型)
* * * * *
# 競拍說明
**用戶發布競拍**
1:先執行【發布線索】接口,添加發布線索后在后臺“競拍系統管理->待競拍客戶”里面會多出一條待競拍客戶。
2:可以查看待競拍客戶詳情,看該競拍是否合法。如果沒什么問題,可以點擊發布競拍。發布競拍后系統將會推送一條消息給用戶,告知用戶有新的競拍。競拍時間為15分鐘(后臺源代碼的配置文件可以修改該時間)
3:發布完競拍以后可以調用【獲取競拍列表】獲取當前正在競拍與競拍成功的客戶。
4:執行【獲取競拍詳細信息】接口可以獲取詳情。這里分兩種情況(前端需要注意,競拍詳情有競拍成功與正在競拍兩種狀態。)競拍成功與正在競拍。競拍成功的詳情會有競拍成功用戶的信息。正在競拍的沒有。
5:當你看了“正在競拍的詳情”以后,覺得該客戶挺好的,你可以調用【競拍】接口進行競拍。