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

请求路径： /dailyCount/{year}

路径参数：

参数名	类型	必填	说明
year	Integer	是	年份，如 2026

请求示例：

GET /app/jobfair/public/jobfair/dailyCount/2026

响应示例：

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