启业家政后台接口文档

知识元 启业

更新历史

目录

Web

1. 家政人员

1.1 添加家政人员

接口地址

/java/web/housekeeping/worker/add

HTTP Content-Type

application/json

HTTP 请求方式

POST

请求参数

参数	必选	类型	说明
RequestBody
name	是	String	名称
picture	是	String	照片
birthday	是	String	生日，格式为2019-04-29
id_num	是	String	身份证号码
phone	是	String	手机号码
education	是	String	文化水平
place	是	String	籍贯，格式为 广东-深圳
nation	是	String	民族
marriage	是	String	婚育情况
service_month	是	int	服务时间，以月为单位
service_num	是	int	服务数量
credentials	否	String	证书，如存在多个证书，格式为 xxx,xxx,xxx
credentials_pic	否	String	证书图片，如存在多个证书图片，格式为 xxx,xxx,xxx
speciality	是	String	专长
description	是	String	个人介绍
evaluate	是	String	评价
category_level	是	JSONArray	服务类型和技能评级，详情请见 Category_Level

Category_Level

参数	必选	类型	说明
category	是	int	服务类型，包括 1-月嫂 2-育婴师 3-保姆 4-催乳师 5-钟点工
level	是	int	技能等级，包括 0初级~9金牌

HTTP 响应状态

200

Data Item

接口示例

Request

Response

1.2 修改家政人员信息

接口地址

/java/web/housekeeping/worker/update

HTTP Content-Type

application/json

HTTP 请求方式

POST

请求参数

参数	必选	类型	说明
RequestBody
name	否	String	名称
picture	否	String	照片
birthday	否	String	生日，格式为2019-04-29
id_num	否	String	身份证号码
phone	否	String	手机号码
education	否	String	文化水平
place	否	String	籍贯，格式为 广东-深圳
nation	否	String	民族
marriage	否	String	婚育情况
service_month	否	int	服务时间，以月为单位
service_num	否	int	服务数量
credentials	否	String	证书，如存在多个证书，格式为 xxx,xxx,xxx
credentials_pic	否	String	证书图片，如存在多个证书图片，格式为 xxx,xxx,xxx
speciality	否	String	专长
description	否	String	个人介绍
evaluate	否	String	评价
category_level	否	JSONArray	服务类型和技能评级，详情请见 Category_Level

Category_Level

参数	必选	类型	说明
category	是	int	服务类型，包括 1-月嫂 2-育婴师 3-保姆 4-催乳师 5-钟点工
level	是	int	技能等级，包括 0初级~9金牌

HTTP 响应状态

200

接口示例

Request

Response

1.3 删除家政人员

接口地址

/java/web/housekeeping/worker/delete

HTTP Content-Type

application/json

HTTP 请求方式

POST

请求参数

参数	必选	类型	说明
RequestBody
id	是	String	家政人员id

HTTP 响应状态

200

data

接口示例

Response
{
"data": 1,
"success": true,
"msg": "操作成功"
}

1.4 查询家政人员信息

接口地址

/java/web/housekeeping/worker/query

HTTP Content-Type

application/json

HTTP 请求方式

GET

请求参数

参数	必选	类型	说明
QureyParams
id	是	int	家政人员id

HTTP 响应状态

200

接口示例

Request

Response

1.5 查询家政人员列表

接口地址

/java/web/housekeeping/worker/list

HTTP Content-Type

application/json

HTTP 请求方式

GET

请求参数

参数	必选	类型	说明
QureyParams
name	否	String	按名称模糊查询
place	否	String	按区域查询
category	否	int	按照服务类别查询
order	否	String	排序，可选 level和age
page	否	int	请求页数
size	否	int	每页数量

HTTP 响应状态

200

Data Item

接口示例

Request

Response

2 家政预约

2.1 修改预约信息

接口地址

/java/web/housekeeping/booking/update

HTTP 请求方式

POST

请求参数

参数	必选	类型	说明
RequestBody
id	是	int	预约ID
from_date	否	String	预约开始时间，格式为 2019-04-29
to_date	否	String	预约结束时间
status	否	int	操作家政人员上岗（1），下岗（2）取消预约（4）

HTTP 响应状态

200

2.2 取消预约

接口地址

/java/web/housekeeping/booking/cancel

HTTP 请求方式

POST

请求参数

参数	必选	类型	说明
RequestBody
id	是	int	预约ID

HTTP 响应状态

200

2.3 查询预约列表

接口地址

/java/web/housekeeping/booking/list

HTTP 请求方式

GET

请求参数

参数	必选	类型	说明
QueryParams
name	String	否	按照名称模糊查询
status	int	否	按照服务状态查询，0-待面试 1-上岗 2-下岗（服务已完成） 4-取消预约
page	否	int	请求页数
size	否	int	每页数量

HTTP 响应状态

200

Data Item

2.4 查询家政人员排班

接口地址

/java/web/housekeeping/booking/worker

HTTP 请求方式

GET

请求参数

参数	必选	类型	说明
QueryParams
worker_id	int	是	家政人员ID

HTTP 响应状态

200

Data Item

List Item

APP

1 家政人员

1.1 查询家政人员信息

接口地址

/java/housekeeping/worker/query

HTTP Content-Type

application/json

HTTP 请求方式

GET

请求参数

参数	必选	类型	说明
QureyParams
id	是	int	家政人员id
employer_id	是	int	雇主ID

HTTP 响应状态

200

Data Item

接口示例

Request

Response

1.2 查询家政人员列表

接口地址

/java/housekeeping/worker/list

HTTP Content-Type

application/json

HTTP 请求方式

GET

请求参数

参数	必选	类型	说明
QureyParams
category	是	int	按照服务类别查询
name	否	String	按名称模糊查询
place	否	String	按区域查询，格式为 广东-深圳
order	否	String	按年龄或者服务类别等级排序，包括 birthday level
page	否	int	请求页数
size	否	int	每页数量

HTTP 响应状态

200

Data Item

接口示例

Request

Response

2 家政预约

2.1 添加预约

接口地址

/java/housekeeping/booking/add

HTTP Content-Type

application/json

HTTP 请求方式

POST

请求参数

参数	必选	类型	说明
employer_id	是	int	雇主id
employer_name	是	string	雇主名称
employer_phone	是	String	雇主手机号码
worker_id	是	int	家政人员id
worker_name	是	string	家政人员名称
worker_phone	是	string	家政人员手机号码
worker_category	是	int	服务类型
worker_level	是	int	服务级别
booking_time	是	string	预订时间，格式为 2019-04-29 12:00:00
from_date	是	string	服务开始时间，格式为 2019-04-29
to_date	是	string	服务结束时间，格式为 2019-04-29
duration	是	int	服务天数
address	是	string	服务地址
live	否	int	是否住家
twins	否	int	是否双胞胎
price	是	float	家政人员费用
commission	是	float	平台佣金
mode	是	String	雇佣方式，day/month/year

HTTP 响应状态

200

2.2 修改预约信息

接口地址

/java/housekeeping/booking/update

HTTP 请求方式

POST

请求参数

参数	必选	类型	说明
RequestBody
id	是	int	预约ID
booking_time	否	string	预订时间，格式为 2019-04-29 12:00:00
from_date	否	string	服务开始时间，格式为 2019-04-29
to_date	否	string	服务结束时间，格式为 2019-04-29
duration	否	int	服务天数
address	否	string	服务地址
live	否	int	是否住家
twins	否	int	是否双胞胎
price	否	float	服务费用

HTTP 响应状态

200

2.3 取消预约

接口地址

/java/housekeeping/booking/cancel

HTTP 请求方式

POST

请求参数

参数	必选	类型	说明
RequestBody
id	是	int	预约ID

HTTP 响应状态

200

2.4 删除预约

接口地址

/java/housekeeping/booking/delete

HTTP 请求方式

POST

请求参数

参数	必选	类型	说明
RequestBody
id	是	int	预约ID

HTTP 响应状态

200

2.5 查询预约信息

接口地址

/java/housekeeping/booking/query

HTTP 请求方式

GET

请求参数

参数	必选	类型	说明
QueryParams
id	是	int	预约ID

HTTP 响应状态

200

Data Item

2.6 我的预约列表

接口地址

/java/housekeeping/booking/mylist

HTTP 请求方式

GET

请求参数

参数	必选	类型	说明
QueryParams
employer_id	是	int	雇主ID
page	否	int	请求页数
size	否	int	每页数量

HTTP 响应状态

200

Data Item

2.7 查询家政人员排班

接口地址

/java/housekeeping/booking/worker

HTTP 请求方式

GET

请求参数

参数	必选	类型	说明
QueryParams
worker_id	int	是	家政人员ID

HTTP 响应状态

200

Data Item

List Item

3 收藏

3.1 添加收藏

接口地址

/java/housekeeping/collect/add

HTTP 请求方式

POST

请求参数

参数	必选	类型	说明
RequestBody
worker_id	是	int	家政人员ID
employer_id	是	int	雇主ID

HTTP 响应状态

200

3.2 取消收藏

接口地址

/java/housekeeping/collect/cancel

HTTP 请求方式

POST

请求参数

参数	必选	类型	说明
RequestBody
id	是	int	收藏ID

HTTP 响应状态

200

3.3 我的收藏

接口地址

/java/housekeeping/collect/mycollect

HTTP 请求方式

POST

请求参数

参数	必选	类型	说明
RequestBody
employer_id	是	int	雇主ID
page	否	int	请求页数
size	否	int	每页数量

HTTP 响应状态

200

Data Item