# offershow.cn 招聘接口说明

> 基础域名：`https://www.offershow.cn`
> 招聘业务接口响应体结构统一为 `{ "code": <int>, "data": <object>, "msg": <string> }`；业务成功码为 **`200001`**。
> 与 xiaozhaoya 不同，**offershow 的 `data` 为明文 JSON，无加密**，拿到即可直接解析。
> 每次请求服务端都会下发一枚匿名访客 Cookie `_uvc_`（`HttpOnly`，有效期约 4 小时），用于访客追踪/风控；当前所有接口**裸调（不带 Cookie / 登录态）即可返回数据**。

## 一、接口总览

| # | 接口 | 方法 | 功能 | 是否需要授权 |
|---|------|------|------|-------------|
| 1 | `/json/category.json` | GET | **职位分类字典**：6 位数编码的两级职位分类树 | 否（静态文件，走 CDN 缓存） |
| 2 | `/api/od/get_company_tags` | GET | **公司行业标签字典**：行业标签 id / 名称 / 关键词 | 否 |
| 3 | `/api/od/get_hot_city` | GET | **热门城市列表**：筛选用城市名数组 | 否 |
| 4 | `/api/od/plan_table` | **POST（JSON body）** | **招聘计划列表**：分页返回招聘计划概要（引用上面 2、3 的字典） | **部分**：未登录时 `page`/`size` 及大部分筛选被忽略，恒返回固定 10 条预览 |

### 重要说明

- **接口 4 必须用 POST + JSON body**：以 GET 或把参数放 query string 调用一律返回 `404 page not found`（`text/plain`）。参数必须写在请求体 JSON 中。
- **未登录的分页限制**：未登录状态下 `plan_table` 的 `page`、`size` 参数均被忽略——无论传 `page=1` 还是 `page=5`、`size=20` 还是 `size=100`，都只返回**固定的第 1 页 10 条**。翻页与自定义每页条数需要登录态。
- **未登录的筛选限制**：仅 `city`（城市）筛选生效（会同时改变 `total` 与返回列表）；`company_many_tags`（行业）、`search_content`（关键词）等筛选**在未登录时被忽略**（`total` 与结果均不变）。

---

## 二、请求示例、参数与返回值

### 接口 1：职位分类字典 `GET /json/category.json`

静态 JSON 文件，无参数，命中腾讯云 CDN 缓存（`x-cache-lookup: Cache Hit`）。

**请求示例**

```bash
curl 'https://www.offershow.cn/json/category.json'
```

**返回值（明文）**

```json
{
  "data": [
    {
      "value": 100000,
      "label": "技术/开发",
      "children": [
        { "value": 101000, "label": "后端开发" },
        { "value": 101700, "label": "前端开发" },
        { "value": 102000, "label": "人工智能/算法" }
        // ...
      ]
    }
    // ... 共 16 个一级分类
  ]
}
```

**编码规律**

- 一级分类：`100000`（技术/开发）、`110000`（产品）、`120000`（设计/交互）…… 按万位递增。
- 二级分类：一级基数 + 千位递增，如技术/开发（`100000`）下的 `101000` 后端开发、`101700` 前端开发。
- 一级分类共 16 个：技术/开发、产品、设计/交互、运营、市场/采购、人事/财务/行政、销售/客服、传媒、金融、教育/科研/培训、医疗健康、咨询/翻译/法律、服务业、生产制造、房地产/建筑、其他。

---

### 接口 2：公司行业标签字典 `GET /api/od/get_company_tags`

**请求示例**

```bash
curl 'https://www.offershow.cn/api/od/get_company_tags'
```

**返回值（明文）**

```json
{
  "code": 200001,
  "data": {
    "company_tags": [
      { "id": 4,  "content": "IT/互联网",     "descriptions": "IT|互联网" },
      { "id": 19, "content": "游戏",          "descriptions": "游戏" },
      { "id": 5,  "content": "硬件/半导体",   "descriptions": "电子|通信|硬件|半导体" }
      // ...
    ]
  },
  "msg": ""
}
```

**字段说明**

| 字段 | 说明 |
|------|------|
| `id` | 行业标签 id，被 `plan_table` 的 `company_many_tags`、`company.industry_type` 引用 |
| `content` | 展示名称 |
| `descriptions` | 该标签涵盖的关键词，`|` 分隔 |

**完整标签表**

| id | content | descriptions |
|----|---------|-------------|
| 4 | IT/互联网 | IT\|互联网 |
| 19 | 游戏 | 游戏 |
| 5 | 硬件/半导体 | 电子\|通信\|硬件\|半导体 |
| 7 | 汽车/自动驾驶 | 新能源\|汽车\|自动驾驶 |
| 13 | 机械/制造业 | 生产\|制造\|机械 |
| 6 | 金融行业 | 金融\|保险\|证券\|投资 |
| 12 | 消费生活 | 消费\|生活\|服务\|娱乐 |
| 17 | 医疗健康 | 医疗\|健康 |
| 14 | 政府/事业单位 | 科研\|政府\|公共事业 |
| 8 | 国企央企 | 国企\|央企\|研究所 |
| 9 | 广告传媒 | 传媒\|印刷\|艺术\|设计 |
| 10 | 建筑/房地产 | 房地产\|建筑\|物业 |
| 18 | 材料/能源/化工 | 能源\|化工\|环保 |
| 16 | 物流/交通运输 | 采购\|贸易\|交通\|物流 |
| 15 | 其他行业 | 其他行业 |

---

### 接口 3：热门城市 `GET /api/od/get_hot_city`

**请求示例**

```bash
curl 'https://www.offershow.cn/api/od/get_hot_city'
```

**返回值（明文）**

```json
{
  "code": 200001,
  "data": {
    "city_list": ["全部", "北京", "上海", "广州", "深圳", "杭州", "成都", "武汉",
      "苏州", "南京", "天津", "郑州", "合肥", "长沙", "济南", "太原", "青岛",
      "石家庄", "西安", "重庆", "厦门", "宁波", "福州", "昆明", "南昌", "佛山", "东莞"]
  },
  "msg": ""
}
```

- 首项为占位项 `"全部"`，其余为可用于 `plan_table` 请求体 `city` 参数的城市名。

---

### 接口 4：招聘计划列表 `POST /api/od/plan_table`

**请求体（JSON）**

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `page` | int | 是 | 页码，从 1 开始。**未登录时被忽略**（恒为第 1 页） |
| `size` | int | 是 | 每页条数。**未登录时被忽略**（恒返回 10 条） |
| `recruit_plan_type` | int | 否 | 招聘计划类型，如 `2`。缺省/传 0 不影响未登录返回 |
| `city` | string | 否 | 城市名（取自接口 3）。**未登录时生效**，会改变 `total` 与返回列表 |
| `search_content` | string | 否 | 关键词搜索。**未登录时被忽略** |
| `company_many_tags` | string | 否 | 行业标签 id（逗号分隔，取自接口 2）。**未登录时被忽略** |
| `recruit_type` | int | 否 | 招聘类型（0=不限） |
| `company_character` | int | 否 | 公司性质（0=不限） |
| `progress_status` | int | 否 | 进度状态（0=不限） |
| `is_recommend` | int | 否 | 是否推荐（0=不限） |
| `object_id` / `column_type` / `title` / `total` | - | 否 | 前端上下文透传字段，不影响未登录查询结果 |

**请求示例**

```bash
curl -X POST 'https://www.offershow.cn/api/od/plan_table' \
  -H 'content-type: application/json' \
  --data '{"page":1,"size":20,"recruit_plan_type":2}'
```

**返回值（明文）**

```json
{
  "code": 200001,
  "data": {
    "total": 29954,
    "is_login": false,
    "is_recruit_vip": false,
    "recruit_vip_num": 134,
    "plans": [
      {
        "uuid": "b67d206c-b93d-4536-8005-6b10ac45eead",
        "company_name": "网易游戏互娱",
        "company_uuid": "管理员录入",
        "company_logo": "/company_logo/2684d697-....jpg",
        "company_many_tags": "4,19",
        "company": {
          "uuid": "", "fullname": "", "nickname": "", "logo": "",
          "address": "", "intro": "", "website_link": "",
          "industry_type": 0, "character": 0, "finance": 0, "scale": 0
        },
        "recruit_title": "网易游戏（互娱）2027届校园招聘正式启动！",
        "recruit_city": "广州 | 杭州 | 上海",
        "positions": "游戏策划类\r\n技术类\r\n用户体验及设计类\r\n产品类\r\n...",
        "recruit_type": 3,
        "plan_type": 2,
        "recruit_plan_type": 1,
        "graduate_type": 1,
        "deliver_type": 1,
        "time_type": 2,
        "is_official": 2,
        "is_recommend": 1,
        "origin": "网易游戏互娱招聘公众号",
        "notice_url": "https://mp.weixin.qq.com/s/....",
        "recommend_code": " ZJwCjn",
        "recommend_type": 1,
        "view_cnt": 180,
        "welfares": "[]",
        "create_time": "2026-07-21T11:31:20+08:00",
        "start_time": "2026-07-21T00:00:00+08:00",
        "end_time": "2027-01-17T00:00:00+08:00",
        "recruit_local_graduate_date_start": "2026-09-01T00:00:00+08:00",
        "recruit_local_graduate_date_end": "2027-08-31T00:00:00+08:00",
        "recruit_overseas_graduate_date_start": "2026-09-01T00:00:00+08:00",
        "recruit_overseas_graduate_date_end": "2027-08-31T00:00:00+08:00"
      }
      // ... 未登录固定返回 10 条
    ]
  },
  "msg": ""
}
```

**`data` 顶层字段**

| 字段 | 说明 |
|------|------|
| `total` | 符合查询条件的总条数（`city` 筛选会改变它；`company_many_tags`/`search_content` 未登录时不改变） |
| `plans` | 招聘计划数组，未登录固定 10 条 |
| `is_login` | 是否已登录（裸调为 `false`） |
| `is_recruit_vip` | 是否招聘 VIP |
| `recruit_vip_num` | VIP 招聘数量 |

**单条 plan 关键字段**

| 字段 | 说明 |
|------|------|
| `uuid` | 招聘计划唯一标识 |
| `company_name` | 公司名 |
| `company_many_tags` | 行业标签 id 列表（逗号分隔），查表见接口 2 |
| `company` | 公司详情对象，未登录时多为空值 |
| `recruit_title` | 招聘标题 |
| `recruit_city` | 招聘城市，` | ` 分隔的自由文本 |
| `positions` | 招聘职位，`\r\n` 分隔的**自由文本**（非接口 1 的编码） |
| `notice_url` | 招聘公告原文链接（常为微信公众号推文） |
| `recruit_type` / `plan_type` / `graduate_type` / `deliver_type` / `time_type` / `is_official` / `is_recommend` | 内部小枚举，无独立字典接口，需前端硬编码映射 |
| `view_cnt` | 浏览量 |
| `create_time` / `start_time` / `end_time` | 时间字段（RFC3339，含 +08:00 时区） |
| `recruit_local_graduate_date_*` / `recruit_overseas_graduate_date_*` | 境内/境外毕业时间窗口 |

---

## 三、字段字典与关联关系

三个"字典接口"（1、2、3）为主数据接口 `plan_table`（4）提供编码含义与筛选选项。

### 1. `get_company_tags.id` ⟷ `plan_table.company_many_tags`（强关联 / 外键）

- `plan_table` 中 `company_many_tags: "4,19"` 是**逗号分隔的行业标签 id 列表**。
- 查表：`4` = IT/互联网，`19` = 游戏 ⇒ 该公司行业为【IT/互联网 + 游戏】。
- 同一字典也对应 `plan_table` 请求体的行业筛选参数 `company_many_tags`（登录后生效），以及 `plan.company.industry_type`（单值主行业）。

### 2. `get_hot_city.city_list` ⟷ `plan_table` 请求体 `city`（筛选入参）

- `city_list` 提供可选城市名，作为 `plan_table` 的 `city` 入参使用；`city` 是未登录唯一生效的筛选条件。
- 注意返回里的 `recruit_city` 是 ` | ` 分隔的自由文本，可含 `city_list` 之外的地名（如"香港/澳门/海外"）。

### 3. `category.json` ⟷ 职位筛选（弱关联）

- `category.json` 是职位分类编码表，用于按职位维度的筛选/搜索（前端级联下拉）。
- **注意**：`plan_table.positions` 是招聘方录入的自由文本（`\r\n` 分隔），**不回填 category 的 `value`**，两者仅语义相关、无 id 级外键。

### 关系图

```
get_company_tags.id ──(逗号分隔多值)──► plan_table.company_many_tags        [强关联/外键]
get_company_tags.id ──(单值主行业)────► plan_table.company.industry_type    [强关联/外键]

get_hot_city.city_list ──(筛选入参)───► plan_table 请求体 city              [筛选条件, 未登录唯一生效]

category.json.value ──(筛选入参)──────► plan_table 职位筛选参数(登录后)      [查询条件]
category.json.label ~~(语义对应,无id)~ plan_table.positions(自由文本)       [弱关联]

plan_table 独立枚举: recruit_type / plan_type / graduate_type / ...        [无字典接口, 需前端硬编码]
```

---

## 四、反爬与鉴权说明

- **访客 Cookie `_uvc_`**：每次请求服务端 `Set-Cookie` 下发，`HttpOnly`、`Domain=www.offershow.cn`、`Max-Age≈15400s`（约 4 小时）。用于匿名访客追踪，当前不影响裸调取数。
- **业务码**：成功统一为 `code: 200001`（非 HTTP 200 语义）。
- **路由约束**：`plan_table` 仅接受 POST + JSON body，误用 GET 返回 `404 page not found`（`text/plain`）。
- **登录门槛**：翻页（`page`≥2）、自定义 `size`、以及 `company_many_tags`/`search_content` 等筛选均需登录态才生效；未登录只能取到第 1 页固定 10 条、且仅 `city` 筛选可用。
- **数据形态**：响应为明文 JSON，无 xiaozhaoya 那样的 AES 加密，无需解密步骤。