猜一猜谜语 API 类型清单：26 类谜语 typeId 完整对照表
# 猜一猜谜语 API 类型清单：26 类谜语 typeId 完整对照表
> 接口/接入点：猜一猜谜语 API · 谜语类型查询（151-3） · 免费 · 返回 JSON · 适用人群：所有调用方（填 typeId 前必查） · 阅读时间：约 4 分钟
## 核心要点
- 类型清单来自 151-3 `typeList`，实返回 **26 类**，可作为 `typeId` 取值的权威来源。
- 简介称"12 类主题"与枚举不符；以本表 26 类为准。
- `mygs`（谜语故事）只在 151-3 类型查询里出现，151-2/151-4 的可枚举参数描述未列它（传入前建议自测）。
## Why：为什么需要这张表
调用 151-2（随机）或 151-4（按类型分页）时都要传 `typeId`。填错 id 要么报错要么拿到不想要的类型。本文给出从官方类型查询接口实拉的完整对照，复制即用。
## What：接口速览
| 项 | 内容 |
|----|------|
| 类型查询地址 | `https://route.showapi.com/151-3?appKey=YOUR_APPKEY` |
| 请求参数 | 无（GET 即可） |
| 返回主结构 | `showapi_res_body.typeList`（`id` / `name`） |
| 用途 | 枚举所有可传 `typeId` |
## How：调用拿到类型清单
```bash
curl -X POST "https://route.showapi.com/151-3?appKey=YOUR_APPKEY" \
-H "content-type: application/x-www-form-urlencoded"
```
返回的 `typeList` 即下表来源（官方实拉 26 类）。
## 完整对照表（typeId ↔ 类型名）
| typeId | 类型名 | 适用场景举例 |
|--------|--------|------------|
| gxmy | 搞笑谜语 | 社交娱乐、破冰 |
| zmmy | 字谜 | 汉字/语文趣味 |
| cymy | 成语谜语 | 成语学习、课堂 |
| dwmy | 动物谜语 | 儿童科普 |
| aqmy | 爱情谜语 | 情感类互动 |
| dmmy | 灯谜谜语 | 元宵/节日活动 |
| rmmy | 人名谜语 | 文史趣味 |
| dimmy | 地名谜语 | 地理科普 |
| cy | 词语谜语 | 语文积累 |
| dgmy | 带格谜语 | 灯谜进阶（带格） |
| ry | 用语谜语 | 语言类游戏 |
| etmy | 儿童谜语 | 亲子/低龄 |
| wpmy | 物品谜语 | 生活认知 |
| zwmy | 植物谜语 | 自然科普 |
| jmmy | 名谜谜语 | 名物类 |
| sbmy | 书报谜语 | 阅读推广 |
| symy | 俗语谜语 | 民俗语言 |
| ypmy | 药品谜语 | 医药科普 |
| yymy | 音乐谜语 | 音乐类互动 |
| ysmy | 影视谜语 | 影视粉丝向 |
| cwmy | 称谓谜语 | 社交称谓 |
| qtmy | 趣味谜语 | 通用娱乐 |
| miyujingxuan | 谜语精选 | 高质量合集 |
| mygs | 谜语故事 | 故事型（见下注） |
| njmy | 脑筋急转弯 | 智力游戏、社群 |
| zlmy | 智力问答 | 知识问答、答题 |
## 返回示例与解析
```json
"showapi_res_body": {
"ret_code": 0,
"typeList": [
{ "id": "gxmy", "name": "搞笑谜语" },
{ "id": "zmmy", "name": "字谜" },
{ "id": "mygs", "name": "谜语故事" },
{ "id": "njmy", "name": "脑筋急转弯" },
{ "id": "zlmy", "name": "智力问答" }
]
}
```
## 进阶/边界
- **`mygs` 谜语故事的特殊性**：151-3 `typeList` 含 `mygs`，但 151-2/151-4 的 `typeId` 可枚举参数描述里**没有** `mygs`。把它当作 `typeId` 传入 151-2/151-4 是否生效，文档未明确，建议自测；稳妥起见优先用上表前 25 类。
- **"12 类"是简介口径**：接口简介写"12 类主题"，实际类型查询返回 26 类，以本表为准。
- 类型名中文在 151-3 返回里带"谜语"后缀（如"搞笑谜语"），调用其他接入点返回的是 `typeName`（同样含后缀），做展示时注意一致性。
## FAQ
**Q1：typeId 填错会怎样？**
填入不存在的 id，接口通常返回空列表或业务错误，不会崩。建议从本表复制 id。
**Q2：为什么简介说 12 类，这里 26 类？**
简介是早期概括口径；实际类型查询接口返回 26 类，以本表为准。
**Q3：mygs 谜语故事能用于随机查询吗？**
151-3 类型列表里有 `mygs`，但 151-2/151-4 的 `typeId` 枚举未列它，能否作为入参生效文档未说明，建议自测。
**Q4：151-3 需要传参数吗？**
不需要，直接 GET/POST 即可拿到全量类型。
**Q5：typeName 和 id 必须都存吗？**
`id` 用于请求，`typeName` 用于展示。建议存映射表，展示时用 `typeName` 而非自己翻译。
## 相关能力 / 下一步阅读
- [猜一猜谜语 API 返回字段全解：三大接入点的 Title/Answer 与分页差异](https://www.showapi.com/guides/riddle-response-fields-151)
- [猜一猜谜语 API：5 分钟接入，调通你的第一条随机谜语](https://www.showapi.com/guides/riddle-quickstart-151)
- [按类型与分页查询谜语：151-4 接入点实战（"关键词"真相）](https://www.showapi.com/guides/riddle-search-by-type-151)
- **本系列共 13 篇**：查看[猜一猜谜语 API 指南总目录](https://www.showapi.com/guides/riddle-guides-151)
