模块说明
job 提供招聘岗位的列表与详情接口：列表支持 class 筛选（工作地点/类型等）与分页，响应含 class_list 筛选选项与 total 总数字段；详情返回岗位档案（职责、要求等）。
鉴权级别：可选。
接口一览
| 方法 | URL | 鉴权 | 说明 |
|---|---|---|---|
| GET | /api/job |
可选 | 岗位列表 |
| GET | /api/job/show/{id} |
可选 | 岗位详情 |
列表
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
class |
否 | 分类筛选值 |
page |
否 | 页码，默认 1 |
响应
{
"code": "OK",
"message": "",
"data": {
"title": "招聘",
"job_list": [ { "id": 1, "name": "...", "class": "...", "...": "" } ],
"class_list": [ { "name": "全部", "value": "" } ],
"total": 6,
"pager": { "page": 1, "page_size": 10, "record_count": 6, "page_count": 1 }
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}| 字段 | 说明 |
|---|---|
total |
岗位总数（来自分页器统计） |
class_list |
可选分类筛选列表 |
详情
GET /api/job/show/1
{
"code": "OK",
"message": "",
"data": {
"title": "岗位名",
"job": { "id": 1, "name": "...", "content": "<p>……</p>", "...": "" }
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}注意事项
- 列表键为
job_list、详情键为job； - 详情 ID 非法返回
422（invalid_job），记录不存在返回404。