shz-backend/docs/app-public-job-fair-api.md

# 公共招聘会接口文档

基础路径：`/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 | 经度 |