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 | 经度 |
|