148 lines
3.6 KiB
Markdown
148 lines
3.6 KiB
Markdown
# 公共招聘会接口文档
|
||
|
||
基础路径：`/app/jobfair/public/jobfair`
|
||
|
||
---
|
||
|
||
## 1. 查看当季度招聘会信息
|
||
|
||
获取当前季度所有招聘会列表。
|
||
|
||
**请求方式：** `GET`
|
||
|
||
**请求路径：** `/currentQuarter`
|
||
|
||
**请求参数：** 无
|
||
|
||
**响应示例：**
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"msg": "操作成功",
|
||
"data": [
|
||
{
|
||
"jobFairId": "101",
|
||
"jobFairTitle": "2026年石河子市新年首场招聘会",
|
||
"jobFairAddress": "石河子市人力资源市场",
|
||
"jobFairType": "2",
|
||
"jobFairStartTime": "2026-01-03 09:00:00",
|
||
"jobFairEndTime": "2026-01-03 16:00:00",
|
||
"jobFairHostUnit": "石河子市人社局",
|
||
"jobFairIntroduction": "新年首场大型综合招聘会",
|
||
"jobFairPhone": "0993-2012345",
|
||
"divisionName": "石河子市",
|
||
"jobFairCategory": "社会招聘"
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 2. 查看当月招聘会信息
|
||
|
||
获取当前月份所有招聘会列表。
|
||
|
||
**请求方式：** `GET`
|
||
|
||
**请求路径：** `/currentMonth`
|
||
|
||
**请求参数：** 无
|
||
|
||
**响应示例：**
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"msg": "操作成功",
|
||
"data": [
|
||
{
|
||
"jobFairId": "101",
|
||
"jobFairTitle": "2026年石河子市新年首场招聘会",
|
||
"jobFairAddress": "石河子市人力资源市场",
|
||
"jobFairType": "2",
|
||
"jobFairStartTime": "2026-01-03 09:00:00",
|
||
"jobFairEndTime": "2026-01-03 16:00:00",
|
||
"jobFairHostUnit": "石河子市人社局",
|
||
"jobFairIntroduction": "新年首场大型综合招聘会",
|
||
"jobFairPhone": "0993-2012345",
|
||
"divisionName": "石河子市",
|
||
"jobFairCategory": "社会招聘"
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 3. 按年份查询每日招聘会数量
|
||
|
||
根据年份查询该年每天的招聘会数量，支持跨天招聘会统计（如招聘会时间为1月12日-14日，则12、13、14日都会统计）。
|
||
|
||
**请求方式：** `GET`
|
||
|
||
**请求路径：** `/dailyCount/{year}`
|
||
|
||
**路径参数：**
|
||
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|-------|------|-----|------|
|
||
| year | Integer | 是 | 年份，如 2026 |
|
||
|
||
**请求示例：**
|
||
```
|
||
GET /app/jobfair/public/jobfair/dailyCount/2026
|
||
```
|
||
|
||
**响应示例：**
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"msg": "操作成功",
|
||
"data": [
|
||
{ "date": "2026-01-03", "count": 1 },
|
||
{ "date": "2026-01-05", "count": 1 },
|
||
{ "date": "2026-01-07", "count": 2 },
|
||
{ "date": "2026-01-15", "count": 1 },
|
||
{ "date": "2026-01-16", "count": 1 },
|
||
{ "date": "2026-02-05", "count": 1 },
|
||
{ "date": "2026-02-12", "count": 1 },
|
||
{ "date": "2026-02-13", "count": 1 },
|
||
{ "date": "2026-02-14", "count": 1 }
|
||
]
|
||
}
|
||
```
|
||
|
||
**响应字段说明：**
|
||
|
||
| 字段名 | 类型 | 说明 |
|
||
|-------|------|------|
|
||
| date | String | 日期，格式 yyyy-MM-dd |
|
||
| count | Integer | 当天招聘会数量 |
|
||
|
||
---
|
||
|
||
## 公共字段说明
|
||
|
||
### 招聘会信息字段
|
||
|
||
| 字段名 | 类型 | 说明 |
|
||
|-------|------|------|
|
||
| jobFairId | String | 招聘会ID |
|
||
| jobFairTitle | String | 招聘会标题 |
|
||
| jobFairAddress | String | 招聘会地址 |
|
||
| jobFairType | String | 招聘会类型：1-线上，2-线下 |
|
||
| jobFairStartTime | String | 开始时间 |
|
||
| jobFairEndTime | String | 结束时间 |
|
||
| jobFairHostUnit | String | 主办单位 |
|
||
| jobFairHelpUnit | String | 协办单位 |
|
||
| jobFairOrganizeUnit | String | 承办单位 |
|
||
| jobFairIntroduction | String | 招聘会简介 |
|
||
| jobFairPhone | String | 联系电话 |
|
||
| jobFairImage | String | 招聘会图片 |
|
||
| divisionName | String | 所属区域 |
|
||
| jobFairCategory | String | 招聘会分类 |
|
||
| enterpriseNum | String | 参会企业数 |
|
||
| boothNum | String | 展位数 |
|
||
| latitude | BigDecimal | 纬度 |
|
||
| longitude | BigDecimal | 经度 |
|