中文分词接口：5 分钟从注册到拿到第一条分词结果
chinese-segmentation-quickstart-269 # 中文分词接口：5 分钟从注册到拿到第一条分词结果
> 接口：中文分词接口（269-1） · 免费 · POST/GET · JSON · 适用人群：新注册用户、初级开发者 · 阅读时间：5 分钟
## 核心要点
- 注册 ShowAPI 账号、拿到 AppKey 后，调用 `https://route.showapi.com/269-1?appKey=YOUR_APPKEY` 即可免费分词。
- 只需传一个必填参数 `text`（要切词的整段中文），返回 `showapi_res_body.list` 就是分词结果数组。
- 本接口免费，但设有使用档位限制；注册即默认可调用，适合先跑通原型。
## Why：这跟我有什么关系
做中文内容的搜索、标签、推荐、评论分析时，第一步往往是要把一整句话拆成一个个"词"。中文不像英文天然有空格，自己写规则切词既费劲又不准。中文分词接口把这件事做成了一个 HTTP 调用：你传一段话，它返回一串词。因为是免费接口，你可以零成本先跑通原型，再决定要不要用到生产环境。
## What：前置条件与接口速览
| 项 | 说明 |
|----|------|
| 接口地址 | `https://route.showapi.com/269-1?appKey={your_appKey}` |
| 接入点 | 269-1（默认分组，本接口仅此 1 个接入点） |
| 请求方式 | POST 或 GET |
| 鉴权 | Query 参数 `appKey` |
| 必填参数 | `text`（String，要切词的整段中文） |
| 返回格式 | JSON，业务数据在 `showapi_res_body` 内 |
| 计费 | 免费服务（注册默认可调用，有档位限制） |
| 集成能力 | MCP 服务、OpenAPI 3.0 文档、多语言示例 |
## How：第一次调用
### 步骤 1：获取 AppKey
登录 [ShowAPI 控制台 MyApp](https://www.showapi.com/console#/myApp)，创建一个应用即可拿到 `appKey`。
### 步骤 2：发起第一次调用（三语言任选）
**Python（标准库，无需额外依赖）**
```python
import urllib.parse
import urllib.request
import json
APP_KEY = "YOUR_APPKEY"
TEXT = "易源接口是api的可插拔总线"
url = f"https://route.showapi.com/269-1?appKey={APP_KEY}"
data = urllib.parse.urlencode({"text": TEXT}).encode("utf-8")
req = urllib.request.Request(
url, data=data,
headers={"content-type": "application/x-www-form-urlencoded"}
)
try:
with urllib.request.urlopen(req, timeout=10) as resp:
result = json.loads(resp.read().decode("utf-8"))
body = result.get("showapi_res_body", {})
if body.get("ret_code") == 0:
print("分词结果：", body.get("list"))
else:
print("业务失败 ret_code=", body.get("ret_code"))
except Exception as e:
print("请求异常：", e)
```
**cURL**
```bash
curl -X POST "https://route.showapi.com/269-1?appKey=YOUR_APPKEY" \
--data-urlencode "text=易源接口是api的可插拔总线"
```
**Node.js（fetch，Node 18+）**
```js
const APP_KEY = "YOUR_APPKEY";
const TEXT = "易源接口是api的可插拔总线";
const url = `https://route.showapi.com/269-1?appKey=${APP_KEY}`;
const body = new URLSearchParams({ text: TEXT }).toString();
fetch(url, {
method: "POST",
headers: { "content-type": "application/x-www-form-urlencoded" },
body
})
.then(r => r.json())
.then(result => {
const b = result.showapi_res_body || {};
if (b.ret_code === 0) console.log("分词结果：", b.list);
else console.log("业务失败 ret_code=", b.ret_code);
})
.catch(e => console.error("请求异常：", e));
```
> 把 `YOUR_APPKEY` 替换成你自己的 AppKey 即可直接运行。客户端超时建议设 10 秒（服务端 read/connect 超时为 5 秒，略留余量）。
## 返回示例与解析
```json
{
"showapi_res_error": "",
"showapi_res_id": "6a9648e5fb638c3463281397",
"showapi_res_code": 0,
"showapi_fee_num": 1,
"showapi_res_body": {"ret_code":0,"list":["易源","接口","api","插拔","总线"]}
}
```
- `showapi_res_body.list`：分词结果数组，`["易源","接口","api","插拔","总线"]` 就是切出来的词。
- `showapi_res_body.ret_code`：`0` 表示成功，非 `0` 表示失败。
- 系统级 `showapi_res_code`：`0` 表示接口调用层成功；`showapi_fee_num` 为本次计费计数。
## 进阶 / 边界
- 返回的是**纯分词字符串数组**，每个元素是一个词；中英文混排时英文/数字会作为独立词切出（如示例中的 `api`）。
- 免费接口有档位限制，频繁调用请参考[免费档位下的限流与调用策略](https://www.showapi.com/guides/chinese-segmentation-free-tier-269)。
## FAQ
**Q：返回里为什么没有词性、实体这类信息？**
A：本接口当前返回结构仅暴露 `list`（分词数组）与 `ret_code`。文档描述中提到的词性标注/命名实体识别/新词识别，在返回字段、OpenAPI schema 与实测返回中均没有对应字段，文章均按真实返回撰写。详见[常见问题与避坑指南](https://www.showapi.com/guides/chinese-segmentation-faq-269)。
**Q：GET 和 POST 都能用吗？**
A：都能用。表单场景用 POST（`application/x-www-form-urlencoded`），简单联调用 GET 把参数放 URL 也可。
**Q：免费会不会有次数上限？**
A：免费但有使用档位限制，具体额度以[官方档位说明](https://www.showapi.com/free-api)为准，本文不罗列具体数字。
**Q：一次能处理多长的文本？**
A：单接口处理整段文本；超长文本建议切片后多次调用，见[长文本切分与批量处理](https://www.showapi.com/guides/chinese-segmentation-long-text-269)。
## 相关能力 / 下一步阅读
- [中文分词接口返回字段全解：list 分词数组与 ret_code 一文读懂](https://www.showapi.com/guides/chinese-segmentation-response-fields-269)
- [中文分词接口：免费档位下的限流与调用策略](https://www.showapi.com/guides/chinese-segmentation-free-tier-269)
- [中文分词接口：如何用分词结果做关键词提取与文本标签](https://www.showapi.com/guides/chinese-segmentation-keyword-extraction-269)
- **本系列共 11 篇**：查看[中文分词接口指南总目录](https://www.showapi.com/guides/chinese-segmentation-guides-269)
