汉字多功能转换器：5 分钟从注册到第一条转换结果（汉字转拼音）
汉字多功能转换器汉字转拼音简繁转换全角半角地址分词 # 汉字多功能转换器：5 分钟从注册到第一条转换结果（汉字转拼音）
> 接口/接入点：汉字多功能转换器 · 汉字转拼音（99-38） · 是否免费：是（注册后默认可调用，有档次限制） · 请求方式：POST/GET · 返回格式：JSON · 适用人群：新注册用户、初级开发者 · 阅读时间：约 5 分钟
## 核心要点
- 这是一个**免费**接口，注册 ShowAPI 账号、拿到 AppKey 即可调用，无需预付费用。
- 汉字转拼音是最常用的接入点：传入中文字符串，返回 `data`（拼音，空格隔开）与 `simpleData`（简写拼音）。
- 调用只需一个必填参数 `content`，给一段文字即可；其余参数均可省略。
## Why：这跟我有什么关系
做教育类 App、输入法、本地化工具或任何"中文要注音"的场景，你都需要把"你好"变成"ni hao"。自己维护拼音词典成本高、多音字难处理；这个接口把这件事变成一次 HTTP 调用。本文带你从 0 把第一次调用跑通。
## What：前置条件与接口速览
| 项 | 说明 |
|----|------|
| 接口地址（汉字转拼音） | `https://route.showapi.com/99-38?appKey=YOUR_APPKEY` |
| 请求方式 | POST 或 GET |
| 鉴权 | Query 参数 `appKey`（从控制台获取） |
| 内容类型 | `application/x-www-form-urlencoded`（`content-type` 头可选） |
| 必填参数 | `content`：需要转换的中文字符串 |
| 计费 | 免费（有使用档次限制，详见档位说明） |
| 集成能力 | MCP 服务、OpenAPI 3.0 文档（均覆盖全部 6 接入点） |
## How：第一次调用
### 步骤 1 — 获取 AppKey
登录 ShowAPI 控制台 →「我的 App」→ 创建/查看应用，复制 `appKey`。下文用 `YOUR_APPKEY` 占位，请替换为你自己的。
### 步骤 2 — 调用（三选一）
**Python（requests）**
```python
import requests
url = "https://route.showapi.com/99-38"
params = {"appKey": "YOUR_APPKEY"}
data = {"content": "你好"} # 必填：需要转换的中文字符串
resp = requests.post(url, params=params, data=data, timeout=10)
result = resp.json()
if result.get("showapi_res_code") == 0:
body = result["showapi_res_body"]
print("拼音:", body["data"]) # ni hao
print("简写:", body["simpleData"]) # n h
print("成功:", body["flag"]) # true (字符串)
else:
print("调用失败:", result.get("showapi_res_error"))
```
**cURL**
```bash
curl -X POST "https://route.showapi.com/99-38?appKey=YOUR_APPKEY" \
-H "content-type: application/x-www-form-urlencoded" \
-d "content=%E4%BD%A0%E5%A5%BD"
```
**Node.js（fetch）**
```javascript
const url = "https://route.showapi.com/99-38?appKey=YOUR_APPKEY";
const res = await fetch(url, {
method: "POST",
headers: { "content-type": "application/x-www-form-urlencoded" },
body: new URLSearchParams({ content: "你好" }),
});
const result = await res.json();
if (result.showapi_res_code === 0) {
const b = result.showapi_res_body;
console.log("拼音:", b.data, "| 简写:", b.simpleData, "| 成功:", b.flag);
}
```
## 返回示例与解析
```json
{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_id": "ce135f6739294c63be0c021b76b6fbff",
"showapi_res_body": {
"data": "ni hao",
"simpleData": "n h",
"flag": "true"
}
}
```
| 字段 | 类型 | 说明 |
|------|------|------|
| `showapi_res_code` | int | 系统状态码，0 表示成功 |
| `showapi_res_body.data` | String | 拼音，音节间空格隔开 |
| `showapi_res_body.simpleData` | String | 简写拼音（仅汉字转拼音接入点返回） |
| `showapi_res_body.flag` | String | 转换是否成功，值为字符串 `"true"` |
## 进阶/边界
- `flag` 是**字符串** `"true"`，不是布尔；判断请用 `== "true"` 或 `=== "true"`。
- 其它 5 个接入点（简繁、全半角）的返回同样含 `data`+`flag`，但**没有** `simpleData`；地址分词接入点结构完全不同（见对应文章）。
- 免费接口有使用档次限制，高频调用请先看档位说明，必要时用积分兑换更高档位。
## FAQ
**Q1：返回里没有 simpleData 怎么办？**
只有「汉字转拼音」接入点返回 `simpleData`；简繁/全半角只有 `data`+`flag`，属正常。
**Q2：flag 是 true 但还是没结果？**
先确认 `showapi_res_code == 0`。若非 0，看 `showapi_res_error` 的具体信息。
**Q3：content 支持多长？**
文档未给出明确上限；建议单条请求控制在合理长度（如几百字内），超长文本分片调用。
**Q4：GET 还是 POST？**
两者都支持。表单提交用 POST 更稳妥；简单测试可用 GET 把 `content` 放 query。
## 相关能力 / 下一步阅读
- [汉字多功能转换器返回字段全解：data / simpleData / flag 与系统级 showapi_res_code](https://www.showapi.com/guides/hanzi-converter-response-fields-99)
- [汉字多功能转换器：汉字转拼音在教育场景的实战（批量生成带拼音生字表）](https://www.showapi.com/guides/hanzi-pinyin-education-99)
- [汉字多功能转换器错误排查：showapi_res_code 与地址分词的 ret_code/msg](https://www.showapi.com/guides/hanzi-converter-errors-99)
- **本系列共 12 篇**：查看[汉字多功能转换器指南总目录](https://www.showapi.com/guides/hanzi-converter-guides-99)
