全量搜索
职责：跨 27 种数据源的统一搜索接口（无需登录）。
全量搜索 API（11 接口 27 数据源）
基础URL:
https://tools.wktyl.com
控制器:app\api\controller\Searchall
维护: Xianyan 团队 | 更新时间: 2026-08-15
跳转: 工具 API · Feed 信息流 · 查重 API
职责：跨 27 种数据源的统一搜索接口（无需登录）。
1. 通用约定
- 所有接口免鉴权
- 响应
{code, msg, time, data} - 频率限制：30/60s，hot 接口单独限制（防刷）
- 频率超限响应：
{code:0, msg:"请求过于频繁"}
2. 接口清单
| 接口 | 方法 | 说明 |
|---|---|---|
/api/searchall/channels |
GET | 开放频道列表（按平台过滤） |
/api/searchall/search |
GET | 全量搜索（跨数据源） |
/api/searchall/exact |
GET | 精确匹配 |
/api/searchall/fuzzy |
GET | 模糊匹配 |
/api/searchall/related |
GET | 相关搜索 |
/api/searchall/condition |
POST | 条件搜索 |
/api/searchall/getById |
GET | 通过 ID 查询 |
/api/searchall/getByIds |
POST | 批量通过 ID 查询 |
/api/searchall/suggest |
GET | 搜索建议（自动补全） |
/api/searchall/hot |
GET | 当前热搜词（后台可配置） |
/api/searchall/hotConfig |
POST | 热搜配置（管理） |
3. 搜索类型
GET /api/searchall/search?q=静夜思&type=poem
支持的 type：poem / hanzi / chengyu / sentence / xiehouyu / duilian / baike / weather / ip / shiwu / ...
完整列表通过 /channels 接口实时返回。
4. 核心示例
4.1 全量搜索
GET /api/searchall/search?q=李白&page=1
# 响应
{
"code": 1,
"data": {
"total": 1234,
"results": [
{ "type": "poem", "id": 8888, "title": "静夜思", "score": 9.8 },
{ "type": "sentence", "id": 123, "text": "床前明月光", "score": 9.5 }
],
"by_type": {
"poem": 256,
"sentence": 78
}
}
}
4.2 搜索建议（自动补全）
GET /api/searchall/suggest?q=李
# 响应
{ "code":1, "data": ["李白", "李清照", "李商隐", "李时珍"] }
5. 设计要点
- 跨 27 数据源：单接口聚合所有数据源搜索结果，前端无需关心查询逻辑
- 支持 v1.3 热搜配置：通过
hotConfig/install后台管理热搜词（时长/开关/置顶/自定义） - 支持 v1.4 开放频道过滤：按平台筛选（Web/iOS/Android）
- 搜索建议基于热度：根据历史搜索频次推荐