汉字多功能转换器：全角半角字符转换实战（数据清洗与文本规范化）
汉字多功能转换器汉字转拼音简繁转换全角半角地址分词 # 汉字多功能转换器：全角半角字符转换实战（数据清洗与文本规范化）
> 接口/接入点：汉字多功能转换器 · 半角转全角（99-115）/ 全角转半角（99-116） · 是否免费：是 · 请求方式：POST/GET · 返回格式：JSON · 适用人群：数据清洗、表单/对账工程师 · 阅读时间：约 6 分钟
## 核心要点
- 半角→全角走 `99-115`，全角→半角走 `99-116`，均只用一个必填参数 `content`。
- 返回 `data`（转换后的字符）+ `flag`（字符串 `"true"`），无 `simpleData`。
- 典型用途：用户录入的账号/金额混用全半角时，先统一成半角再入库或比对。
## Why：为什么需要全半角转换
用户在前端输手机号、金额、优惠券码时，常常误用全角数字/字母（如"１２３"而非"123"），直接入库会导致去重、对账、匹配全部失败。全半角转换是把脏数据规范化的第一道工序。
## What：接口速览
| 项 | 半角→全角 | 全角→半角 |
|----|-----------|-----------|
| 路径 | `/99-115` | `/99-116` |
| 必填 | `content` | `content` |
| 返回 | `data`, `flag` | `data`, `flag` |
## How：规范化用户输入
**Python（全角→半角，清洗用户输入）**
```python
import requests
def normalize(text):
r = requests.post(
"https://route.showapi.com/99-116",
params={"appKey": "YOUR_APPKEY"},
data={"content": text}, timeout=10).json()
if r.get("showapi_res_code") == 0 and r["showapi_res_body"]["flag"] == "true":
return r["showapi_res_body"]["data"]
return text # 失败时保底返回原文
raw = "订单号：ＡＢ１２３，金额：１２３４元"
print(normalize(raw)) # 订单号：AB123，金额：1234元
```
**cURL（半角→全角）**
```bash
curl -X POST "https://route.showapi.com/99-115?appKey=YOUR_APPKEY" \
-d "content=AB123"
```
**Node.js（fetch）**
```javascript
const r = await fetch("https://route.showapi.com/99-116?appKey=YOUR_APPKEY", {
method: "POST",
headers: { "content-type": "application/x-www-form-urlencoded" },
body: new URLSearchParams({ content: "ＡＢ１２３" }),
}).then(x => x.json());
console.log(r.showapi_res_body.data);
```
## 返回示例与解析
```json
{ "showapi_res_code": 0, "showapi_res_body": { "data": "AB123", "flag": "true" } }
```
| 字段 | 说明 |
|------|------|
| `data` | 转换后的字符（半角或全角，取决于接入点） |
| `flag` | 字符串 `"true"` 表示成功 |
## 进阶/边界
- 转换聚焦常见 ASCII 全半角（数字、字母、标点），特殊符号的映射以接口实际返回为准。
- 清洗链路建议"先全角→半角统一，再做去空格/大写化/去重"，顺序影响结果。
- `flag` 为字符串，判断用 `== "true"`；失败时保底返回原文，避免数据丢失。
## FAQ
**Q1：转换后能保证所有符号都归一吗？**
覆盖常见全半角字符；个别特殊符号以接口实际返回为准，关键数据建议二次校验。
**Q2：为什么没有 simpleData？**
全半角接入点只返回 `data`+`flag`，`simpleData` 仅汉字转拼音有。
**Q3：大批数据怎么调？**
分片 + 限流调用，避免触发免费档次限制；失败按 `showapi_res_code` 重试。
**Q4：和简繁转换是同一个接口吗？**
不是。简繁是 99-113/99-114，全半角是 99-115/99-116。
## 相关能力 / 下一步阅读
- [汉字多功能转换器返回字段全解：data / simpleData / flag 与系统级 showapi_res_code](https://www.showapi.com/guides/hanzi-converter-response-fields-99)
- [汉字多功能转换器：简繁体互转实战（跨地区文档与古籍数字化）](https://www.showapi.com/guides/hanzi-simple-tradition-convert-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)
