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:当你看了“正在竞拍的详情”以后,觉得该客户挺好的,你可以调用【竞拍】接口进行竞拍。