API 文档

公共接口、系统参数、配置

POST 上传文件 /employer/common/upload

上传文件

权限

是

Headers

无

参数

名称	类型	必选	描述
file	File	是	文件流

正文

无

参数

追加

响应输出

返回参数

无

{
    "code": "状态码",
    "msg": "提示信息",
    "time": "时间戳",
    "data": [{
    "url": "半路径地址",
    "fullurl": "全路径地址"
    }]
    }

GET/POST 获取工种列表 /employer/common/workTypeList

需要token

权限

否

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    "code": "状态码",
    "msg": "提示信息",
    "time": "时间戳",
    "data": [{
    "name": "名称",
    "value": "值"
    }]
    }

GET/POST 获取有工人的工种列表 /employer/common/workTypeListExist

需要token

权限

否

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    "code": "状态码",
    "msg": "提示信息",
    "time": "时间戳",
    "data": [{
    "name": "名称",
    "value": "值"
    }]
    }

GET/POST 获取评价标签列表 /employer/common/tagsList

需要token

权限

是

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    "code": "状态码",
    "msg": "提示信息",
    "time": "时间戳",
    "data": [{
    "name": "名称",
    "value": "值"
    }]
    }

GET/POST 获取信息类型列表 /employer/common/infoTypeList

需要token

权限

是

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    "code": "状态码",
    "msg": "提示信息",
    "time": "时间戳",
    "data": [{
    "name": "名称",
    "value": "值"
    }]
    }

GET/POST 获取取消原因列表 /employer/common/cancelReasonList

需要token

权限

是

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    "code": "状态码",
    "msg": "提示信息",
    "time": "时间戳",
    "data": [{
    "name": "名称",
    "value": "值"
    }]
    }

GET/POST 获取用户服务协议 /employer/common/getServiceAgreement

不需要token

权限

是

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    "code": "状态码",
    "msg": "提示信息",
    "time": "时间戳",
    "data": [{
    "name": "名称",
    "value": "值"
    }]
    }

企业

POST/GET 搬家服务列表 /employer/company/moveHouseIndex

token

权限

否

Headers

无

参数

名称	类型	必选	描述
page	int	否	页数
limit	int	否	每页显示条数
like	int	否	模糊查询（名称、简介）

正文

无

参数

追加

page

limit

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    'code': '状态码',
    'msg': '提示信息',
    "time": "时间戳",
    'data': [{
    "company_id":"企业ID",
    "workman_id":"企业用户ID",
    "company_logo":"企业LOGO",
    "company_name":"企业名称",
    "company_industry":"行业名称值"
    "industry_name":"行业名称"
    }]
    }

POST/GET 家政服务列表 /employer/company/housekeepingIndex

token

权限

否

Headers

无

参数

名称	类型	必选	描述
page	int	否	页数
limit	int	否	每页显示条数
like	int	否	模糊查询（名称、简介）

正文

无

参数

追加

page

limit

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    'code': '状态码',
    'msg': '提示信息',
    "time": "时间戳",
    'data': [{
    "company_id":"企业ID",
    "workman_id":"企业用户ID",
    "company_logo":"企业LOGO",
    "company_name":"企业名称",
    "company_industry":"行业名称值"
    "industry_name":"行业名称"
    }]
    }

POST/GET 维修服务列表 /employer/company/repairIndex

token

权限

否

Headers

无

参数

名称	类型	必选	描述
page	int	否	页数
limit	int	否	每页显示条数
like	int	否	模糊查询（名称、简介）

正文

无

参数

追加

page

limit

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    'code': '状态码',
    'msg': '提示信息',
    "time": "时间戳",
    'data': [{
    "company_id":"企业ID",
    "workman_id":"企业用户ID",
    "company_logo":"企业LOGO",
    "company_name":"企业名称",
    "company_industry":"行业名称值"
    "industry_name":"行业名称"
    }]
    }

POST/GET 保姆月嫂列表 /employer/company/nannyIndex

token

权限

否

Headers

无

参数

名称	类型	必选	描述
page	int	否	页数
limit	int	否	每页显示条数
like	int	否	模糊查询（名称、简介）

正文

无

参数

追加

page

limit

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    'code': '状态码',
    'msg': '提示信息',
    "time": "时间戳",
    'data': [{
    "company_id":"企业ID",
    "workman_id":"企业用户ID",
    "company_logo":"企业LOGO",
    "company_name":"企业名称",
    "company_industry":"行业名称值"
    "industry_name":"行业名称"
    }]
    }

POST/GET 企业人员列表 /employer/company/personList

token

权限

是

Headers

无

参数

名称	类型	必选	描述
company_id	int	否	企业ID
page	int	否	页数
limit	int	否	每页显示条数
like	int	否	模糊查询（姓名、手机号、技能特长）
worktype	int	否	工种

正文

无

参数

追加

company_id

page

limit

worktype

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    'code': '状态码',
    'msg': '提示信息',
    "time": "时间戳",
    'data': [{
    "company_id":"企业ID",
    "person_id":"人员ID",
    "person_name":"人员姓名",
    "status":"人员状态normal：在线，hidden：停用，suspend：暂停",
    "star":"星级分数",
    "workman_id":"人员用户ID",
    "age":"年龄",
    "grade":"级别",
    "oerdernums":"接单数量",
    "regyears":"注册年长",
    "work_types":"注册工种"
    }]
    }

首页

GET/POST 获取附近的工人 /employer/index/nearby

不需要token

权限

否

Headers

无

参数

名称	类型	必选	描述
lon	string	是	经度
lat	string	是	纬度
distance	string	是	km范围
worktype	string	是	工种

正文

无

参数

追加

lon

lat

distance

worktype

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    "code": "状态码",
    "msg": "提示信息",
    "time": "时间戳",
    "data": [{
    "workman_id": "工人ID",
    "workman_avatar": "头像"
    }]
    }

信息

GET/POST 获取信息列表 /employer/information/infoList

不需要token

权限

否

Headers

无

参数

名称	类型	必选	描述
page	int	否	当前页数
limit	int	否	每页显示条数
type	int	否	类型（/employer/common/infoTypeList的value）
like	string	否	用标题/内容/ 搜索

正文

无

参数

追加

page

limit

type

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    "code": "状态码",
    "msg": "提示信息",
    "time": "时间戳",
    "data": [{
    "id": "信息ID",
    "info_type": "信息类型",
    "title": "信息标题",
    "publish_time": "发布日期"
    }]
    }

GET/POST 获取信息详情 /employer/information/infoDetail

不需要token

权限

否

Headers

无

参数

名称	类型	必选	描述
id	int	否	信息ID

正文

无

参数

追加

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    "code": "状态码",
    "msg": "提示信息",
    "time": "时间戳",
    "data": [{
    "id": "信息ID",
    "info_type": "信息类型",
    "title": "信息标题",
    "publish_time": "发布日期",
    "images": [
    "图片"
    ],
    "ctcg_name": "姓名",
    "ctcg_mobile": "电话",
    "ctcg_address": "地址"
    }]
    }

POST 添加信息 /employer/information/infoAdd

需要token

权限

是

Headers

无

参数

名称	类型	必选	描述
info_type	string	是	信息发布类型
title	string	是	标题
text_content	string	是	文字说明
images	string	否	图片
ctcg_name	string	是	姓名
ctcg_mobile	string	是	电话
ctcg_address	string	是	地址

正文

无

参数

追加

info_type

title

text_content

images

ctcg_name

ctcg_mobile

ctcg_address

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    "code": "状态码",
    "msg": "提示信息",
    "time": "时间戳",
    "data": []
    }

GET/POST 是否有信息发布权限 /employer/information/isRights

不需要token

权限

否

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    "code": "状态码",
    "msg": "提示信息",
    "time": "时间戳",
    "data": [{
    "id": "信息ID",
    "info_type": "信息类型",
    "title": "信息标题",
    "publish_time": "发布日期"
    }]
    }

订单-企业

POST 预约工人 /employer/orders.company_order/add

需要token

权限

是

Headers

无

参数

名称	类型	必选	描述
company_id	string	是	企业ID
workman_user_id	string	是	工人用户ID
order_place	string	是	下单地点
order_place_lon	string	是	下单地点经度
order_place_lat	string	是	下单地点纬度
distance	string	是	km范围
order_work_type	string	是	需求工种参数值
order_phone	int	否	下单手机号
order_demand	string	否	需求文字描述
order_demand_images	string	否	需求图片地址
order_service_time	string	否	上门时间（时间戳或者年-月-日时:分）

正文

无

参数

追加

company_id

workman_user_id

order_place

order_place_lon

order_place_lat

distance

order_work_type

order_phone

order_demand

order_demand_images

order_service_time

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    "code": "状态码",
    "msg": "提示信息",
    "time": "时间戳",
    "data": [{
    "order_number": "订单编号",
    "order_place": "下单地点",
    "order_place_lon": "下单地点经度",
    "order_place_lat": "下单地点纬度",
    "order_work_name": "需求工种",
    "order_demand": "需求文字说明",
    "order_demand_images": [
    "需求图片地址"
    ],
    "order_status": "订单状态值",
    "is_evaluate": "是否评价值",
    "order_found_time": "下单时间戳",
    "order_close_time": "取消订单时间戳",
    "order_taking_time": "接单时间戳",
    "order_finish_time": "订单完成时间戳",
    "evaluate_time": "评价时间戳",
    "order_status_text": "订单状态名称",
    "is_evaluate_text": "是否评价名称",
    "is_close_status": "取消状态值",
    "is_close_status_text": "取消状态名称",
    "order_found_time_text": "下单时间",
    "order_close_time_text": "取消订单时间",
    "order_taking_time_text": "接单时间",
    "order_finish_time_text": "订单完成时间",
    "evaluate_time_text": "评价时间",
    "order_user": {
    "mobile": "下单用户手机号",
    "nickname": "下单用户昵称",
    "avatar": "下单用户头像"
    },
    "taking_user": {
    "mobile": "接单用户手机号",
    "real_name": "接单用户姓名",
    "nickname": "接单用户昵称",
    "avatar": "接单用户头像"
    }
    }]
    }

订单-评价

GET/POST 评价订单 /employer/orders.evaluate/add

需要token

权限

是

Headers

无

参数

名称	类型	必选	描述
order_number	string	是	订单编号
star	int	是	星级数
tags	string	否	评价标签
content	string	否	评价内容
images	string	否	图片，可传多张，多张用逗号隔开

正文

无

参数

追加

order_number

star

GET/POST 获取某工人的用户评价列表 /employer/orders.evaluate/getEvaluateList

需要token

权限

是

Headers

无

参数

名称	类型	必选	描述
workman_id	string	否	工人ID
page	int	否	页数
limit	int	否	每页显示条数

正文

无

参数

追加

workman_id

page

limit

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    "code": "状态码",
    "msg": "提示信息",
    "time": "时间戳",
    "data": [{
    "evaluateTags": [{
        "tag":"评价标签",
        "nums":"数量"
        }],
    "evaluateFaceTags": [{
        "star":"星级（1：哭脸，3：正常，5：笑脸）",
        "nums":"数量"
    }],
    "evaluate": [{
        "username":"用户名",
        "nickname":"昵称",
        "avatar":"头像",
        "star":"星级及分数",
        "content":"评价内容",
        "images":"评价图片",
        "createdate":"评价日期"
        }]
    }]
    }

GET/POST 获取评价数量 /employer/orders.evaluate/getEvaluateCount

需要token

权限

是

Headers

无

参数

名称	类型	必选	描述
is_evaluate	string	否	评价状态（1：已评价，0：待评价）

正文

无

参数

追加

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    "code": "状态码",
    "msg": "提示信息",
    "time": "时间戳",
    "data": [{
    "counts" : "数量"
    }]
    }

GET/POST 获取评价订单列表 /employer/orders.evaluate/getEvaluateOrderList

需要token

权限

是

Headers

无

参数

名称	类型	必选	描述
is_evaluate	string	否	评价状态（1：已评价，0：待评价）
page	int	否	页数
limit	int	否	每页显示条数

正文

无

参数

追加

is_evaluate

page

limit

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    "code": "状态码",
    "msg": "提示信息",
    "time": "时间戳",
    "data": [{
    "rows":{
    "order_number": "订单编号",
    "order_status": "订单状态值",
    "order_work_name": "订单工种",
    "order_demand": "订单内容",
    "is_evaluate": "是否可评价值",
    "createtime": "时间戳",
    "createdate": "日期",
    "real_name": "接单人",
    "mobile": "接单人手机号",
    "avatar": "接单人头像",
    "party_member": "接单人是否党员",
    "order_status_text": "订单状态名称",
    "is_evaluate_text": "是否可评价名称"
    },
    "totalPage" : "总页数"
    }]
    }

订单-完成订单

GET/POST 获取完成订单请求 /employer/orders.finish/getFinishOrderRequest

需要token

权限

是

Headers

无

参数

名称	类型	必选	描述
order_number	string	否	订单编号

正文

无

参数

追加

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    "code": "状态码",
    "msg": "提示信息",
    "time": "时间戳",
    "data": [{
    "order_number": "订单编号"
    }]
    }

GET/POST 确认是否同意完成订单 /employer/orders.finish/confirmFinishOrderRequest

需要token

权限

是

Headers

无

参数

名称	类型	必选	描述
order_number	string	是	订单编号
agree	int	是	同意为1反之为0

正文

无

参数

追加

order_number

agree

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    "code": "状态码",
    "msg": "提示信息",
    "time": "时间戳",
    "data": []
    }

订单数据

GET/POST 获取订单列表 /employer/orders.index/index

需要token

权限

是

Headers

无

参数

名称	类型	必选	描述
status	string	否	订单状态值
page	int	否	页数
limit	int	否	每页显示条数

正文

无

参数

追加

status

page

limit

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    "code": "状态码",
    "msg": "提示信息",
    "time": "时间戳",
    "data": [{
     "rows":{
        "order_number": "订单编号",
        "order_status": "订单状态值",
        "order_work_name": "订单工种",
        "order_demand": "订单内容",
        "is_evaluate": "是否可评价值",
        "createtime": "时间戳",
        "createdate": "日期",
        "real_name": "接单人",
        "mobile": "接单人手机号",
        "avatar": "接单人头像",
        "party_member": "接单人是否党员",
        "order_status_text": "订单状态名称",
        "is_evaluate_text": "是否可评价名称"
    },
     "totalPage" : "总页数"
    }]
    }

GET/POST 获取订单详情 /employer/orders.index/detail

需要token

权限

是

Headers

无

参数

名称	类型	必选	描述
order_number	string	是	订单编号

正文

无

参数

追加

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    "code": "状态码",
    "msg": "提示信息",
    "time": "时间戳",
    "data": [{
    "order_number": "订单编号",
    "order_place": "下单地点",
    "order_place_lon": "下单地点经度",
    "order_place_lat": "下单地点纬度",
    "order_work_name": "需求工种",
    "order_demand": "需求文字说明",
    "order_demand_images": [
    "需求图片地址"
    ],
    "order_phone": "订单手机号",
    "order_status": "订单状态值",
    "is_evaluate": "是否评价值",
    "order_found_time": "下单时间戳",
    "order_close_time": "取消订单时间戳",
    "order_taking_time": "接单时间戳",
    "order_finish_time": "订单完成时间戳",
    "evaluate_time": "评价时间戳",
    "order_status_text": "订单状态名称",
    "is_evaluate_text": "是否评价名称",
    "is_close_status": "取消状态值",
    "is_close_status_text": "取消状态名称",
    "auto_close": "是否自动取消（1：是，0：否）",
    "order_found_time_text": "下单时间",
    "order_close_time_text": "取消订单时间",
    "order_taking_time_text": "接单时间",
    "order_finish_time_text": "订单完成时间",
    "evaluate_time_text": "评价时间",
    "order_service_time_text": "上门时间",
    "order_user": {
    "mobile": "下单用户手机号",
    "nickname": "下单用户昵称",
    "avatar": "下单用户头像"
    },
    "taking_user": {
    "mobile": "接单用户手机号",
    "real_name": "接单用户姓名",
    "nickname": "接单用户昵称",
    "avatar": "接单用户头像"
    }
    }]
    }

订单-接单前

POST 发布需求 /employer/orders.order/add

需要token

权限

是

Headers

无

参数

名称	类型	必选	描述
order_place	string	是	下单地点
order_place_lon	string	是	下单地点经度
order_place_lat	string	是	下单地点纬度
distance	string	是	km范围
order_work_type	string	是	需求工种参数值
peple_nums	int	否	人数
order_phone	int	否	下单手机号
order_demand	string	否	需求文字描述
order_demand_images	string	否	需求图片地址
order_service_time	string	否	上门时间（时间戳或者年-月-日时:分）

正文

无

参数

追加

order_place

order_place_lon

order_place_lat

distance

order_work_type

peple_nums

order_phone

order_demand

order_demand_images

order_service_time

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    "code": "状态码",
    "msg": "提示信息",
    "time": "时间戳",
    "data": [{
    "order_number": "订单编号",
    "order_place": "下单地点",
    "order_place_lon": "下单地点经度",
    "order_place_lat": "下单地点纬度",
    "order_work_name": "需求工种",
    "order_demand": "需求文字说明",
    "order_demand_images": [
    "需求图片地址"
    ],
    "order_status": "订单状态值",
    "is_evaluate": "是否评价值",
    "order_found_time": "下单时间戳",
    "order_close_time": "取消订单时间戳",
    "order_taking_time": "接单时间戳",
    "order_finish_time": "订单完成时间戳",
    "evaluate_time": "评价时间戳",
    "order_status_text": "订单状态名称",
    "is_evaluate_text": "是否评价名称",
    "is_close_status": "取消状态值",
    "is_close_status_text": "取消状态名称",
    "order_found_time_text": "下单时间",
    "order_close_time_text": "取消订单时间",
    "order_taking_time_text": "接单时间",
    "order_finish_time_text": "订单完成时间",
    "evaluate_time_text": "评价时间",
    "order_user": {
    "mobile": "下单用户手机号",
    "nickname": "下单用户昵称",
    "avatar": "下单用户头像"
    },
    "taking_user": {
    "mobile": "接单用户手机号",
    "real_name": "接单用户姓名",
    "nickname": "接单用户昵称",
    "avatar": "接单用户头像"
    }
    }]
    }

GET/POST 取消订单 /employer/orders.order/close

需要token

权限

是

Headers

无

参数

名称	类型	必选	描述
order_number	string	是	订单编号
agree	string	是	类型1无条件取消2协商取消
memo	string	是	取消说明

正文

无

参数

追加

order_number

agree

memo

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    "code": "状态码",
    "msg": "提示信息",
    "time": "时间戳",
    "data": []
    }

订单-接单

GET/POST 获取抢单用户列表 /employer/orders.taking/getTakingWorkmanList

需要token

权限

是

Headers

无

参数

名称	类型	必选	描述
order_number	string	否	订单编号

正文

无

参数

追加

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    "code": "状态码",
    "msg": "提示信息",
    "time": "时间戳",
    "data": [{
    "id": "抢单ID",
    "order_number": "订单编号",
    "mobile": "抢单用户手机号",
    "nickname": "抢单用户昵称",
    "real_name": "抢单用户真实姓名",
    "avatar": "抢单用户头像",
    "gender": "性别（1：男 2：女）",
    "work_types": "工种",
    "party_member": "是否党员（1：党员 0：非党员）",
    "star": "平均星数",
    "grade": "会员等级",
    "age": "年龄",
    "regyears": "注册年限",
    "last_lon": "经度",
    "last_lat": "纬度"
    }]
    }

GET/POST 获取接单成功用户列表 /employer/orders.taking/getTakingSuccessWorkmanList

需要token

权限

是

Headers

无

参数

名称	类型	必选	描述
order_number	string	否	订单编号

正文

无

参数

追加

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    "code": "状态码",
    "msg": "提示信息",
    "time": "时间戳",
    "data": [{
    "id": "抢单ID",
    "order_number": "订单编号",
    "mobile": "抢单用户手机号",
    "nickname": "抢单用户昵称",
    "real_name": "抢单用户真实姓名",
    "avatar": "抢单用户头像"
    }]
    }

GET/POST 选择确认抢单 /employer/orders.taking/confirmOrderTaking

需要token

权限

是

Headers

无

参数

名称	类型	必选	描述
id	int	是	抢单ID
order_number	string	是	订单编号

正文

无

参数

追加

order_number

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    "code": "状态码",
    "msg": "提示信息",
    "time": "时间戳",
    "data": []
    }

签到

GET/POST 用户签到 /employer/signin/userSignin

需要token

权限

是

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    'code': '状态码',
    'msg': '提示信息',
    "time": "时间戳",
    'data': [{
     "score" : "本次增加积分"
     }]
    }

GET/POST 获取签到积分数据 /employer/signin/getSignin

需要token

权限

是

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    'code': '状态码',
    'msg': '提示信息',
    "time": "时间戳",
    'data': [{
    "scoresAmount" : "总积分",
    "max_days" : "最大签到天数",
    "days" : "当前连续签到天数",
    "is_signin" : "当天是否已经签到1：已签到 0：未签到",
    "scoreData" : [{
        "day" : "连续签到天数",
        "score" : "连续签到天数所对应的积分"
        }],
    "explain" : [{
        "title" : "积分说明一类标题",
        "content" : "对应的说明内容"
        }]
    }]
    }

用户

GET/POST 发送短信验证码 /employer/user/sms

不需要token

权限

否

Headers

无

参数

名称	类型	必选	描述
mobile	string	是	手机号

正文

无

参数

追加

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    'code': '状态码',
    'msg': '提示信息',
    "time": "时间戳",
    'data': []
    }

POST 手机验证码登录 /employer/user/login

不需要token

权限

否

Headers

无

参数

名称	类型	必选	描述
mobile	string	是	手机号
sms_code	string	是	短信验证码
openid	string	是	openid

正文

无

参数

追加

mobile

sms_code

openid

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    'code': '状态码',
    'msg': '提示信息',
    "time": "时间戳",
    'data': [{
    "mobile": "手机号",
    "avatar": "头像地址",
    "token": "token",
    "createtime": "token生成时间戳",
    "expiretime": "token失效时间戳",
    "expires_in": "token有效期"
    }]
    }

POST/GET 获取微信信息 /employer/user/getOpenId

不需要token

权限

否

Headers

无

参数

名称	类型	必选	描述
code	string	是	小程序code

正文

无

参数

追加

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    'code': '状态码',
    'msg': '提示信息',
    "time": "时间戳",
    'data': [{
    "session_key": "微信session_key",
    "openid": "微信openid"
    }]
    }

GET/POST 注销 /employer/user/logout

需要token

权限

是

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    'code': '状态码',
    'msg': '提示信息',
    "time": "时间戳",
    'data': []
    }

POST 第三方登录 /employer/user/third

不需要token

权限

否

Headers

无

参数

名称	类型	必选	描述
code	string	是	code
thirdtype	string	是	第三方类型：wechat（微信），wechatmini（微信小程序），alipay（支付宝），qq（腾讯QQ），weibo（新浪微博）

正文

无

参数

追加

code

thirdtype

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    'code': '状态码',
    'msg': '提示信息',
    "time": "时间戳",
    'data': [{
    "mobile": "手机号",
    "avatar": "头像地址",
    "token": "token",
    "createtime": "token生成时间戳",
    "expiretime": "token失效时间戳",
    "expires_in": "token有效期"
    }]
    }

POST 第三方注册且登录 /employer/user/thirdRegister

不需要token

权限

否

Headers

无

参数

名称	类型	必选	描述
code	string	是	code
encryptedData	string	是	encryptedData
iv	string	是	iv
nickname	string	是	昵称
avatar	string	是	头像
thirdtype	string	是	第三方类型：wechat（微信），wechatmini（微信小程序），alipay（支付宝），qq（腾讯QQ），weibo（新浪微博）
platform	string	是	平台（andriod、ios、wechat）
registration_id	string	否	设备ID

正文

无

参数

追加

code

encryptedData

nickname

avatar

thirdtype

platform

registration_id

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    'code': '状态码',
    'msg': '提示信息',
    "time": "时间戳",
    'data': [{
    "mobile": "手机号",
    "avatar": "头像地址",
    "token": "token",
    "createtime": "token生成时间戳",
    "expiretime": "token失效时间戳",
    "expires_in": "token有效期"
    }]
    }

POST 修改个人信息 /employer/user/changeUserInfo

需要token

权限

是

Headers

无

参数

名称	类型	必选	描述
nickname	string	是	昵称
avatar	string	是	头像

正文

无

参数

追加

nickname

avatar

响应输出

返回参数

名称	类型	描述
code	int	状态码
msg	string	提示信息
time	int	时间戳
data	object	返回数据

{
    'code': '状态码',
    'msg': '提示信息',
    "time": "时间戳",
    'data': [{
    "mobile": "手机号",
    "avatar": "头像地址",
    "token": "token",
    "createtime": "token生成时间戳",
    "expiretime": "token失效时间戳",
    "expires_in": "token有效期"
    }]
    }