汉字多功能转换器返回字段全解：data / simpleData / flag 与系统级 showapi_res_code

# 汉字多功能转换器返回字段全解：data / simpleData / flag 与系统级 showapi_res_code > 接口/接入点：汉字多功能转换器（全部 6 个接入点） · 是否免费：是 · 返回格式：JSON · 适用人群：已接入或准备接入的开发者 · 阅读时间：约 6 分钟 ## 核心要点 - 所有接入点都包裹在同一套**系统级信封**里：`showapi_res_code` / `showapi_res_error` / `showapi_res_id` / `showapi_fee_num`。 - 业务数据都在 `showapi_res_body` 内；但**各接入点的业务字段并不一致**。 - 关键差异：汉字转拼音独有 `simpleData`；地址分词用 `ret_code`/`msg`/`result`，与其它 5 个接入点完全不同。 ## Why：为什么需要一张字段速查表 这个接口把 6 种能力塞进了一个 apiCode。新手最容易犯的错误是"拿汉字转拼音的 `data`+`flag` 去套地址分词"，结果解析报错。本文把所有接入点的返回结构一次说清，作为全系列的可搜附录。 ## What：接口速览 | 项 | 说明 | |----|------| | 统一地址前缀 | `https://route.showapi.com/99-XX?appKey=YOUR_APPKEY` | | 系统信封 | `showapi_res_code`、`showapi_res_error`、`showapi_res_id`、`showapi_fee_num` | | 业务数据位置 | `showapi_res_body` 对象内 | ## How：读懂返回结构 ### 系统级信封（所有接入点一致） ```json { "showapi_res_code": 0, "showapi_res_error": "", "showapi_res_id": "ce135f6739294c63be0c021b76b6fbff", "showapi_fee_num": 1, "showapi_res_body": { } } ``` | 字段 | 类型 | 说明 | |------|------|------| | `showapi_res_code` | int | 状态码，0 表示成功，非 0 看 `showapi_res_error` | | `showapi_res_error` | String | 错误信息，成功时为空 | | `showapi_res_id` | String | 本次请求唯一标识 | | `showapi_fee_num` | int | 本次调用计费次数 | ### 6 个接入点的业务字段对照 | 接入点 | 路径 | 业务字段 | 说明 | |--------|------|---------|------| | 汉字转拼音 | 99-38 | `data`, `simpleData`, `flag` | `simpleData` 仅此接入点有 | | 简体转繁体 | 99-113 | `data`, `flag` | `data` 为转换后的字符串 | | 繁体转简体 | 99-114 | `data`, `flag` | `data` 为转换后的简体 | | 半角转全角 | 99-115 | `data`, `flag` | `data` 为全角结果 | | 全角转半角 | 99-116 | `data`, `flag` | `data` 为半角结果 | | 地址分词 | 99-117 | `ret_code`, `msg`, `result` | ⚠️ 注意：不是 `data`/`flag` | ### 地址分词返回示例（结构不同） ```json { "showapi_res_code": 0, "showapi_res_body": { "ret_code": 0, "result": "云南省 昆明市 五华区 学府路 745号", "msg": "" } } ``` > `ret_code` 为 0 表示成功；`msg` 在无错误时不存在；`result` 仅在 `ret_code=0` 时返回。 ## 进阶/边界 - `flag` 是**字符串** `"true"`，不是布尔。 - 地址分词返回的是业务级 `ret_code`（number），与系统级 `showapi_res_code`（int）是两个不同字段，别混淆。 - 系统级 `showapi_res_code` 非 0 时，`showapi_res_body` 可能为空或缺少业务字段，务必先判断再读。 ## FAQ **Q1：为什么我的地址分词结果里没有 data/flag？** 地址分词返回 `ret_code`/`msg`/`result`，和其它接入点的 `data`/`flag` 是两套结构。 **Q2：simpleData 在简繁转换里也有吗？** 没有，`simpleData` 仅汉字转拼音（99-38）返回。 **Q3：showapi_res_code 非 0 时怎么处理？** 读取 `showapi_res_error` 的文案定位问题；详见错误排查文章。 **Q4：showapi_fee_num 是什么？** 本次调用的计费次数，免费档位内也会返回，用于核对消耗。 ## 相关能力 / 下一步阅读 - [汉字多功能转换器：地址分词实战（物流/地图场景的地址智能切分）](https://www.showapi.com/guides/hanzi-address-segment-99) - [汉字多功能转换器错误排查：showapi_res_code 与地址分词的 ret_code/msg](https://www.showapi.com/guides/hanzi-converter-errors-99) - [汉字多功能转换器：5 分钟从注册到第一条转换结果（汉字转拼音）](https://www.showapi.com/guides/hanzi-converter-quickstart-99) - **本系列共 12 篇**：查看[汉字多功能转换器指南总目录](https://www.showapi.com/guides/hanzi-converter-guides-99)