CoCalc provides the best real-time collaborative environment for Jupyter Notebooks, LaTeX documents, and SageMath, scalable from individual users to large groups and classes!
CoCalc provides the best real-time collaborative environment for Jupyter Notebooks, LaTeX documents, and SageMath, scalable from individual users to large groups and classes!
Path: blob/master/番外篇/接口文档参考示例.md
Views: 729
接口文档参考示例
用户登录 - POST
/api/login/
开发者:骆昊
版本号:v1
最后修改时间:
接口说明:登录成功后,会生成或更新用户令牌(token)。
使用帮助:测试数据库中预设了四个可供使用的账号,如下表所示。
用户名 用户口令 角色 jackfrued 123456 管理员 wangdachui 123123 普通用户 hellokitty 123123 房地产经理人 wuzetian 123456 房东 请求参数:
参数名 类型 是否必填 参数位置 说明 username 字符串 是 消息体 用户名 password 字符串 是 消息体 用户口令 响应信息:
登录成功:
登录失败:
发送短信验证码 - GET
/api/mobile_code/{国内手机号}/
开发者:骆昊
版本号:v1
接口说明:给指定手机号发送短信验证码的接口,手机号必须是国内手机号,作为路径参数写到URL中。接口显示短信发送成功时,指定的手机号并不会收到短息,因为使用的三方短信平台赠送的测试短信已经用完了。
使用帮助:国内手机号暂不支持国际区号。
请求参数:暂无。
响应信息:
请求成功:
两次请求间隔小于60秒:
手机号无效:
短信服务平台故障:
获取所有省级行政单位 - GET
/api/districts/
开发者:骆昊
版本号:v1
接口说明:暂无。
使用帮助:暂无。
请求参数:暂无。
响应信息:
获取指定行政单位详情及其管辖的行政单位 - GET
/api/districts/{行政单位编号}/
开发者:骆昊
版本号:v1
接口说明:通过URL参数指定行政单位编号,如果行政单位编号为省级行政单位编号,则返回该省以及该省所辖市级行政单位的信息;如果行政单位编号为市级行政单位编号,则返回该市以及该市所辖区县的信息;如果行政单位编号为区县一级行政单位编号,则返回该区县的信息,下级行政单位
cities
属性值为[]
。使用帮助:数据库中除四川省外其他行政单位的“intro”数据都没有录入,该字段可能为空字符串。
请求参数:暂无。
响应信息:
获取热门城市 - GET
/api/hotcities/
开发者:骆昊
版本号:v1
接口说明:暂无。
使用帮助:暂无。
请求参数:暂无。
响应信息:
分页获取房地产经理人信息 - GET
/api/agents/
开发者:骆昊
版本号:v1
接口说明:经理人姓名按照前缀模糊匹配的方式进行处理;经理人服务星级是指经理人服务星级不得低于该星级;经理人是否持证只有0(未持证上岗)和1(持证上岗)两个选项。三个参数代表的筛选条件之间是而且的关系。返回结果为分页之后的房地产经理人信息。
使用帮助:暂无。
请求参数:
参数名 类型 是否必填 参数位置 说明 name 字符串 否 查询参数 经理人姓名 key 字符串 否 查询参数 经理人服务星级 cert 字符串 否 查询参数 经理人是否持证 page 整数 否 查询参数 页码,默认值为1 size 整数 否 查询参数 页面大小,默认值为5,最大值不超过50 响应信息:
新增房地产经理人 - POST
/api/agents/
开发者:骆昊
版本号:v1
接口说明:暂无。
使用帮助:需要登录且拥有管理员权限,用户身份令牌在请求头中提供。
请求参数:
参数名 类型 是否必填 参数位置 说明 name 字符串 是 消息体 经理人姓名 tel 字符串 是 消息体 经理人手机 servstar 整数 否 消息体 默认值0 realstar 整数 否 消息体 默认值0 profstar 整数 否 消息体 默认值0 certificated 整数 否 消息体 默认值0 token 字符串 是 请求头 用户身份认证令牌 响应信息:
新增成功 - 状态码201:
未提供身份认证信息 - 状态码401:
当前用户没有操作权限 - 状态码403:
编辑房地产经理人信息 - PUT
/api/agents/{房地产经理人编号}/
开发者:骆昊
版本号:v1
接口说明:暂无。
使用帮助:需要登录且拥有管理员权限,用户身份令牌在请求头中提供。
请求参数:
参数名 类型 是否必填 参数位置 说明 name 字符串 是 消息体 经理人姓名 tel 字符串 是 消息体 经理人手机 servstar 整数 否 消息体 默认值0 realstar 整数 否 消息体 默认值0 profstar 整数 否 消息体 默认值0 certificated 整数 否 消息体 默认值0 token 字符串 是 请求头 用户身份认证令牌 响应信息:
更新成功 - 状态码200:
未提供身份认证信息 - 状态码403 - 与新增类同
当前用户没有操作权限 - 状态码403 - 与新增类同
删除房地产经理人 - DELETE
/api/agents/{房地产经理人编号}/
开发者:骆昊
版本号:v1
接口说明:暂无。
使用说明:暂无。
请求参数:
参数名 类型 是否必填 参数位置 说明 token 字符串 是 请求头 用户身份认证令牌 响应信息:
删除成功 - 状态码204
未提供身份认证信息 - 状态码403 - 与新增类同
当前用户没有操作权限 - 状态码403 - 与新增类同
分页获取楼盘信息 - GET
/api/estates/
开发者:骆昊
版本号:v1
接口说明:经理人姓名按照前缀模糊匹配的方式进行处理;经理人服务星级是指经理人服务星级不得低于该星级;经理人是否持证只有0(未持证上岗)和1(持证上岗)两个选项。三个参数代表的筛选条件之间是而且的关系。返回结果为分页之后的房地产经理人信息。
使用帮助:暂无。
请求参数:
参数名 类型 是否必填 参数位置 说明 name 字符串 否 查询参数 楼盘名(模糊匹配) dist 字符串 否 查询参数 楼盘所在地区编号 page 整数 否 查询参数 页码,默认值为1 size 整数 否 查询参数 页面大小,默认值为5,最大值不超过50 响应信息:
新增楼盘 - POST
/api/estates/
开发者:骆昊
版本号:v1
接口说明:暂无。
使用帮助:需要登录且拥有管理员权限,用户身份令牌在请求头中提供。
请求参数:
参数名 | 类型 | 是否必填 | 参数位置 | 说明 |
---|---|---|---|---|
name | 字符串 | 是 | 消息体 | 楼盘名称 |
hot | 整数 | 否 | 消息体 | 楼盘热度,默认值0 |
intro | 字符串 | 否 | 消息体 | 楼盘介绍,默认值空字符串 |
distid | 整数 | 是 | 消息体 | 楼盘所在地区编号 |
token | 字符串 | 是 | 请求头 | 用户身份认证令牌 |
响应信息:
新增成功 - 状态码201:
未提供身份认证信息 - 状态码403:
当前用户没有操作权限 - 状态码403:
编辑楼盘信息 - PUT
/api/estates/{楼盘编号}
删除楼盘信 - DELETE
/api/estates/{楼盘编号}
获取所有户型信息 - GET
/api/housetypes/
新增户型 - POST
/api/housetypes/
编辑户型信息 - PUT
/api/housetypes/{户型编号}
删除户型 - DELETE
/api/housetypes/{户型编号}
分页获取房源信息 - GET
/api/houseinfos/
开发者:骆昊
版本号:v1
接口说明:暂无。
使用帮助:暂无。
请求参数:
参数名 类型 是否必填 参数位置 说明 title 字符串 否 查询参数 房源标题关键词 dist 整数 否 查询参数 楼盘所在地区编号 min_price 整数 否 查询参数 价格区间下限 max_price 整数 否 查询参数 价格区间上限 type 整数 否 查询参数 户型编号 page 整数 否 查询参数 页码,默认值为1 size 整数 否 查询参数 页面大小,默认值为5,最大值不超过50 响应信息:
查看房源详情 - GET
/api/houseinfos/{房源编号}
新增房源 - POST
/api/houseinfos/
编辑房源信息 - PUT
/api/houseinfos/{房源编号}
删除房源 - DELETE
/api/houseinfos/{房源编号}
随机获取指定数量的房源标签 - GET
/api/tags/
分页查看房源标签 - GET
/api/tags/
新增房源标签 - POST
/api/tags/
删除房源标签 - DELETE
/api/tags/{房源编号}
查看房源的图片 - GET
/api/houseinfos/{房源编号}/photos/
为房源添加图片 - POST
/api/houseinfos/{房源编号}/photos/
删除房源图片 - DELETE
/api/houseinfos/{房源编号}/photos/{图片编号}