# 知乎（zhi_hu）接口台账

> 唯一证据来源：`/tmp/aiddit_captures/zhihu_search.json`、`zhihu_search_retry.json`（2026-06-11 真实抓包）。
> 全部接口走统一爬虫网关 `host = http://crawler.aiddit.com`，平台名 `zhi_hu`。

## 平台级结论（先读）

- **整平台 blocked**：知乎关键词搜索两次请求（含变参重试）**均返回 `code=10000 / msg="未知错误" / data=null`**（`zhihu_search.json`、`zhihu_search_retry.json`）。
- 因 search 即失败，**detail / blogger / account_info / 视频下载 全部无法触达，无任何真实样本**，本批 capture 仅有 search 一条且失败。
- 知乎平台 **当前不可用**，下游游走（内容、作者、tag、下载）全部阻断。

---

## 接口 1：关键词搜索（唯一接口，失败）

### ① 身份
- `source_id`: **PLT_ZHIHU_KEYWORD**
- 状态：**blocked**（`zhihu_search.json` + `zhihu_search_retry.json` 两次 `code=10000`）

### ② 请求标准
- method：`POST`，path：`/crawler/zhi_hu/keyword`
- 参数表（依两次请求体）：

| 参数 | 类型 | 必填 | 含义 | 真实值 |
|---|---|---|---|---|
| `keyword` | string | 是 | 搜索词 | `"彩虹"` |
| `cursor` | string | 否 | 翻页游标（重试时尝试） | `""` |
| `content_type` | string | 否 | 内容类型（重试时尝试） | `"综合"` |

### ③ 真实 curl
```bash
# 第一次（最小参数）
curl -X POST 'http://crawler.aiddit.com/crawler/zhi_hu/keyword' \
  -H 'Content-Type: application/json' \
  -d '{"keyword":"彩虹"}'

# 第二次（变参重试，仍失败）
curl -X POST 'http://crawler.aiddit.com/crawler/zhi_hu/keyword' \
  -H 'Content-Type: application/json' \
  -d '{"keyword":"彩虹","cursor":"","content_type":"综合"}'
```

### ④ 响应信封 + 翻页
```json
{ "code": 10000, "msg": "未知错误", "data": null }
```
- 两次请求响应一致：`code=10000`、`msg="未知错误"`、`data=null`。
- **无 `has_more`/`next_cursor`**（data 为 null），翻页不可得。

### ⑤ 字段台账
- **无字段可登记**：`data=null`，未取得任何内容/标题/视频地址/作者/tag/互动数/翻页字段。

### ⑥ 提取与后处理规则
- 不适用（无数据返回）。

### ⑦ 边界与失败
- **失败实证**：`zhihu_search.json` `code=10000 / "未知错误"`；变参重试 `zhihu_search_retry.json` 同样 `code=10000 / "未知错误"`。两次重试均失败 → 判定**知乎整平台 blocked**。
- 限流 ≥ 15s（与其余平台一致，但本平台已 blocked，限流不再是瓶颈）。
- 后续若上游修复，需重新抓包验证 search 是否回到 `code=0`，再补 detail/作者/下载链路。

### ⑧ 落点（canonical + 游走边）
- canonical：无（无数据）。
- 游走边：`search_page_to_content`、`video_to_author`、`author_to_works`、`video_to_hashtag` **全部阻断**，知乎暂不接入游走。
