141 lines
3.1 KiB
Markdown
141 lines
3.1 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`
|
||
|
||
**请求路径：** `/dates`
|
||
|
||
**请求参数：** 无
|
||
|
||
**请求示例：**
|
||
```
|
||
GET /app/jobfair/public/jobfair/dates
|
||
```
|
||
|
||
**响应示例：**
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"msg": "操作成功",
|
||
"data": [
|
||
"2026-01-03",
|
||
"2026-01-05",
|
||
"2026-01-07",
|
||
"2026-01-11",
|
||
"2026-01-15",
|
||
"2026-01-16",
|
||
"2026-01-25",
|
||
"2026-01-26",
|
||
"2026-02-05",
|
||
"2026-02-10",
|
||
"2026-02-12",
|
||
"2026-02-13",
|
||
"2026-02-14"
|
||
]
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 公共字段说明
|
||
|
||
### 招聘会信息字段
|
||
|
||
| 字段名 | 类型 | 说明 |
|
||
|-------|------|------|
|
||
| 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 | 经度 |
|