首页 开发文档 汉字笔画查询

汉字笔画查询

汉字笔画查询。一次可查询最多 20 个汉字,返回每个字的笔画数、拼音与部首,并汇总总笔画数与平均笔画数。数据来自本地汉字字库,覆盖常用简体汉字,适用于姓名笔画分析、起名字数搭配、教育类应用与汉字学习工具。

请求信息
请求地址 https://cx4.cn/openApi/data/stroke 复制
请求方式 GET / POST
接口标识 data_stroke
鉴权方式 必须
四种方式任选其一:Header「X-Api-Key」/ Header「Authorization: Bearer 你的key」/ URL 参数「?key=你的key」/ POST 参数「key」
请求参数
参数名 类型 必填 说明 示例
word string 是 待查询的汉字,最多 20 个(也可用 text 传) 张三
返回参数

下表字段位于返回结构的 data 内;外层 code / message 为全平台统一格式,不在此重复列出。

参数名 类型 说明 示例
ok bool 是否成功 true
word string 查询的词 张三
char_count int 字符个数 2
total_strokes int 总笔画数 7
avg_strokes float 平均笔画数 3.5
found int 命中字库的数量 2
missed array 字库中未收录的字符 []
detail array 逐字明细,含笔画数、拼音与部首 []
note string 说明 笔画数以简体字库为准
返回示例

成功

{
    "code": 200,
    "message": "操作成功",
    "data": {
        "ok": true,
        "word": "张三",
        "char_count": 2,
        "total_strokes": 10,
        "avg_strokes": 5,
        "found": 2,
        "missed": [],
        "detail": [
            {
                "word": "张",
                "strokes": 7,
                "pinyin": "zhānɡ",
                "radicals": "弓"
            },
            {
                "word": "三",
                "strokes": 3,
                "pinyin": "sān",
                "radicals": "一"
            }
        ],
        "note": "笔画数以简体字为准,繁体字笔画可能不同"
    }
}

失败

{
    "code": 400,
    "message": "缺少待统计的汉字",
    "data": null
}
平台通用状态码
状态码 说明
200调用成功
400缺少必填参数或参数格式有误
401密钥缺失或无效
402余额不足,请充值后重试
403未开通该接口,请在本页开通后调用
404接口不存在或已下架
429触发限流,请稍后重试
500接口调用失败(已扣款的会自动退款)
调用示例

cURL 复制

curl -X POST "https://cx4.cn/openApi/data/stroke" -H "X-Api-Key: 你的SecretKey" -d "word=张三"

JavaScript 复制

fetch('https://cx4.cn/openApi/data/stroke', {
  method: 'POST',
  headers: {
    'X-Api-Key': '你的SecretKey',
    'Content-Type': 'application/x-www-form-urlencoded'
  },
  body: 'word=张三'
})
.then(res => res.json())
.then(data => console.log(data));

PHP 复制

post('https://cx4.cn/openApi/data/stroke', [
    'headers' => ['X-Api-Key' => '你的SecretKey'],
    'form_params' => ['word' => '张三'],
]);
echo $response->getBody();

Java 复制

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://cx4.cn/openApi/data/stroke"))
    .header("X-Api-Key", "你的SecretKey")
    .header("Content-Type", "application/x-www-form-urlencoded")
    .POST(HttpRequest.BodyPublishers.ofString("word=张三"))
    .build();
HttpResponse response = client.send(
        request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Python 复制

import requests

res = requests.post('https://cx4.cn/openApi/data/stroke',
    headers={'X-Api-Key': '你的SecretKey'},
    data={'word': '张三'})
print(res.json())
在线测试 (使用你的密钥真实调用,计费与正常调用一致)

登录后可在线测试: 立即登录

计费说明

¥0.0010

每次调用


每日免费额度:100 次

累计调用:3 次


快速上手

1. 注册并完成邮箱验证:立即注册

2. 登录后复制 Secret Key:去登录

3. 点击右侧「开通接口」按钮

4. 用下方「在线测试」一键体验,或复制下方示例代码直接调用