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

公共招聘会接口文档

基础路径：/app/jobfair/public/jobfair

---

1. 查看当季度招聘会信息

获取当前季度所有招聘会列表。

请求方式： GET

请求路径： /currentQuarter

请求参数： 无

响应示例：

{
  "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

请求参数： 无

响应示例：

{
  "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

响应示例：

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