## 添加私客
> 代號：1000_u2
>可能返回的錯誤碼：999，1006
+++
Xmkz_v3/PrivateGuest/addUserGuest
*customer_name=私客姓名 #
*customer_phone=私客電話 #
certificates=身份證 #
address=地址 #
*house_type_id=需求的房源類型 #
*entrust_type=委托類型 #
*price_units_id=價格單位ID #
*price=價格上限 #
*region=委托區域 #
*company_name=委托公司名稱 #
*industry_id=公司名稱ID #
*describe=描述 #
*settled=是否立即入駐 #
*user_id=用戶ID #
<<<
success
{
"data": "2", //私客ID
"info": "添加成功",
"code": 1000,
"state": 1
}
<<<
error
{
"data": "",
"info": "請輸入2到4位字的姓名。",
"code": 1006,
"state": 2
}
+++
## 搜索私客
> 代號：1000_s4
>可能返回的錯誤碼：999，998，1020，1006
+++
get:Xmkz_v3/PrivateGuest/searchUserGuest?token=用戶token
*page=當前頁數 #
*searchKey=搜索關鍵字 #
<<<
success
{
"data": [
{
"id": "1",
"customer_name": "方法", //私客姓名
"customer_phone": "15507898841", //私客電話
"lead_num": "0" //帶看次數
}
],
"info": "查詢成功。",
"code": 1000,
"state": 1
}
<<<
error
+++
## 獲取私客列表
> 代號：1000_u2
>可能返回的錯誤碼：999，1006
+++
get:Xmkz_v3/PrivateGuest/addUserGuest?token=用戶token
*page=需要獲取的頁數，默認為第一頁 #
<<<
success
{
"data": {
"total": "2", //私客總數
"list": [
{
"id": "2",
"customer_name": "222",
"customer_phone": "15507898841",
"lead_num": "0"
},
{
"id": "1",
"customer_name": "方法",
"customer_phone": "15507898841",
"lead_num": "0"
}
]
},
"info": "查詢成功",
"code": 1000,
"state": 1
}
<<<
error
{
"data": “”,
"info": "暫無私客信息",
"code": 1017,
"state": 2
}
+++
## 獲取私客列表
> 代號：1000_u2
>可能返回的錯誤碼：999，1006
+++
get:Xmkz_v3/PrivateGuest/getStateUserGuest?token=用戶token
*page=需要獲取的頁數，默認為第一頁 #
*state=狀態 # //0為全部私客，1為已帶看私客。2為未帶看私客
<<<
success
{
"data": {
"total": "2", //私客總數
"list": [
{
"id": "2",
"customer_name": "222",
"customer_phone": "15507898841",
"lead_num": "0"
},
{
"id": "1",
"customer_name": "方法",
"customer_phone": "15507898841",
"lead_num": "0"
}
]
},
"info": "查詢成功",
"code": 1000,
"state": 1
}
<<<
error
{
"data": “”,
"info": "暫無私客信息",
"code": 1017,
"state": 2
}
+++
## 獲取私客詳情
> 代號：1000_u2
>可能返回的錯誤碼：999，1006
+++
get:Xmkz_v3/PrivateGuest/getUserGuestDetails?token=用戶token
*GuestId=私客ID #
<<<
success
{
"data": {
"id": "1",
"customer_name": "方法",
"customer_phone": "15507898841",
"certificates": "450521199508125555",
"address": "0",
"house_type_id": "2",
"entrust_type": "1",
"demand_area": "a:2:{s:16:\"demand_ar",
"price_units_id": "1",
"price": "11",
"region": "22",
"company_name": "11",
"industry_id": "1",
"describe": "2222",
"settled": "0",
"user_id": "0",
"lead_num": "0"
},
"info": "查詢成功",
"code": 1000,
"state": 1
}
<<<
error
{
"data": "",
"info": "私客ID不可為空",
"code": 1018,
"state": 2
}
+++
## 添加普通帶看
> 代號：1000_s4
>可能返回的錯誤碼：999，998，1020，1006
+++
post:Xmkz_v3/PrivateGuest/lead_see?token=用戶token
*user_guest_id=私客ID #
*house_type_id=用戶自己的戶型 #
*content=私客ID #
*image_data_id=圖片表ID。json格式【上傳圖片后，會返回圖片IMG，將多張圖片的ID轉為json格式】 // 如：[1,2,3,4,5] #
<<<
success
{
"data": "",
"info": "添加成功。",
"code": 1000,
"state": 1
}
<<<
error
{
"data": "",
"info": "上傳的圖片格式不正確",
"code": 1020,
"state": 2
}
+++
