| Header名称 | 默认值 | 必填 | 说明 |
|---|---|---|---|
X-API-Key |
你的API密钥
|
是 | 逗号APIKEY,用户后台首页获取 |
Content-Type |
application/json
|
是 | 请求内容类型 |
| 参数名 | 默认值 | 必填 | 说明 |
|---|---|---|---|
api_id |
57 |
是 | API接口ID,系统默认 |
endpoint_id |
ep_9d56b80119d55e1ce0d85629655c9010 |
是 | 端点ID,系统默认 |
method |
POST |
是 | 请求方式,可选值:GET,POST |
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
action |
string | 是 | 接口类型:convert(使用默认值) | |
text |
string | 是 | 要转换的汉字文本 | 我爱音乐和数学 |
mode |
string | 否 | 转换模式: - with_tone: 带声调(默认) - no_tone: 不带声调 - first_letter: 首字母 - first_letter_upper: 首字母大写 | with_tone |
| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
success |
boolean | 请求是否成功 | |
code |
integer | 状态码:200成功,其他为错误 | |
message |
string | 返回消息 | |
data |
object | 返回数据 | |
data.original |
string | 原始输入文本 | |
data.pinyin |
string | 转换后的拼音 | |
data.mode |
string | 使用的转换模式 | |
data.char_count |
integer | 字符数量 | |
timestamp |
integer | 时间戳 | |
{"success":true,"code":200,"message":"success","data":{"original":"我爱音乐和数学","pinyin":"wǒ ài yīn yuè hé shù xué","mode":"with_tone","char_count":7},"execution_time":0.016,"timestamp":1788744812}
{"success":false,"code":400,"message":"缺少text参数,请输入要转换的汉字","data":null,"execution_time":0.004,"timestamp":1788744832}
| Header名称 | 默认值 | 必填 | 说明 |
|---|---|---|---|
X-API-Key |
你的API密钥
|
是 | 逗号APIKEY,用户后台首页获取 |
Content-Type |
application/json
|
是 | 请求内容类型 |
| 参数名 | 默认值 | 必填 | 说明 |
|---|---|---|---|
api_id |
57 |
是 | API接口ID,系统默认 |
endpoint_id |
ep_geyx8yup3_1788744334166 |
是 | 端点ID,系统默认 |
method |
POST |
是 | 请求方式,可选值:GET,POST |
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
action |
string | 是 | 接口类型:lookup(使用默认值) | |
pinyin |
string | 否 | 要查询的拼音(不带声调) | ai |
| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
data.pinyin |
string | 查询的拼音 | |
data.hanzi_list |
array | 汉字列表 | |
data.hanzi_list[].hanzi |
string | 汉字 | |
data.hanzi_list[].pinyin |
string | 拼音(带声调) | |
data.hanzi_list[].is_polyphone |
boolean | 是否多音字 | |
data.hanzi_list[].all_pinyin |
array | 所有读音(多音字) | |
data.total |
integer | 结果总数 | |
timestamp |
integer | 时间戳 | |
{"success":true,"code":200,"message":"success","data":{"pinyin":"ai","hanzi_list":[{"hanzi":"伌","pinyin":"ài","is_polyphone":false,"all_pinyin":["ài"]},{"hanzi":"佁","pinyin":"ǎi","is_polyphone":true,"all_pinyin":["ǎi","chì","yǐ"]},{"hanzi":"僾","pinyin":"ài","is_polyphone":false,"all_pinyin":["ài"]},{"hanzi":"凒","pinyin":"ái","is_polyphone":false,"all_pinyin":["ái"]},{"hanzi":"叆","pinyin":"ài","is_polyphone":false,"all_pinyin":["ài"]},{"hanzi":"哀","pinyin":"āi","is_polyphone":false,"all_pinyin":["āi"]},{"hanzi":"哎","pinyin":"āi","is_polyphone":false,"all_pinyin":["āi"]},{"hanzi":"唉","pinyin":"ài","is_polyphone":true,"all_pinyin":["ài","āi"]},{"hanzi":"啀","pinyin":"ái","is_polyphone":false,"all_pinyin":["ái"]},{"hanzi":"嗌","pinyin":"ài","is_polyphone":true,"all_pinyin":["ài","yì"]},{"hanzi":"嗳","pinyin":"ài","is_polyphone":true,"all_pinyin":["ài","ǎi","āi"]},{"hanzi":"嘊","pinyin":"ái","is_polyphone":false,"all_pinyin":["ái"]},{"hanzi":"噯","pinyin":"ài","is_polyphone":true,"all_pinyin":["ài","ǎi","āi"]},{"hanzi":"埃","pinyin":"āi","is_polyphone":false,"all_pinyin":["āi"]},{"hanzi":"堨","pinyin":"ài","is_polyphone":true,"all_pinyin":["ài","è","yè"]},{"hanzi":"塧","pinyin":"ài","is_polyphone":false,"all_pinyin":["ài"]},{"hanzi":"壒","pinyin":"ài","is_polyphone":false,"all_pinyin":["ài"]},{"hanzi":"娭","pinyin":"āi","is_polyphone":true,"all_pinyin":["āi","xī"]},{"hanzi":"娾","pinyin":"ái","is_polyphone":true,"all_pinyin":["ái","ǎi","è"]},{"hanzi":"嫒","pinyin":"ài","is_polyphone":false,"all_pinyin":["ài"]},{"hanzi":"嬡","pinyin":"ài","is_polyphone":false,"all_pinyin":["ài"]},{"hanzi":"嵦","pinyin":"ái","is_polyphone":true,"all_pinyin":["ái","kǎi"]},{"hanzi":"愛","pinyin":"ài","is_polyphone":false,"all_pinyin":["ài"]},{"hanzi":"懓","pinyin":"ài","is_polyphone":false,"all_pinyin":["ài"]},{"hanzi":"懝","pinyin":"ài","is_polyphone":true,"all_pinyin":["ài","nǐ","yì"]},{"hanzi":"挨","pinyin":"ái","is_polyphone":true,"all_pinyin":["ái","āi"]},{"hanzi":"捱","pinyin":"ái","is_polyphone":false,"all_pinyin":["ái"]},{"hanzi":"敱","pinyin":"ái","is_polyphone":true,"all_pinyin":["ái","zhú"]},{"hanzi":"敳","pinyin":"ái","is_polyphone":true,"all_pinyin":["ái","zhú"]},{"hanzi":"昹","pinyin":"ǎi","is_polyphone":false,"all_pinyin":["ǎi"]},{"hanzi":"暧","pinyin":"ài","is_polyphone":false,"all_pinyin":["ài"]},{"hanzi":"曖","pinyin":"ài","is_polyphone":false,"all_pinyin":["ài"]},{"hanzi":"欬","pinyin":"ài","is_polyphone":true,"all_pinyin":["ài","kài","ké"]},{"hanzi":"欸","pinyin":"ǎi","is_polyphone":true,"all_pinyin":["ǎi","éi","èi","ěi","ēi"]},{"hanzi":"毐","pinyin":"ǎi","is_polyphone":false,"all_pinyin":["ǎi"]},{"hanzi":"溰","pinyin":"ái","is_polyphone":false,"all_pinyin":["ái"]},{"hanzi":"溾","pinyin":"āi","is_polyphone":false,"all_pinyin":["āi"]},{"hanzi":"濭","pinyin":"ǎi","is_polyphone":true,"all_pinyin":["ǎi","kài","kè"]},{"hanzi":"焥","pinyin":"ài","is_polyphone":true,"all_pinyin":["ài","wò"]},{"hanzi":"爱","pinyin":"ài","is_polyphone":false,"all_pinyin":["ài"]},{"hanzi":"瑷","pinyin":"ài","is_polyphone":false,"all_pinyin":["ài"]},{"hanzi":"璦","pinyin":"ài","is_polyphone":false,"all_pinyin":["ài"]},{"hanzi":"癌","pinyin":"ái","is_polyphone":false,"all_pinyin":["ái"]},{"hanzi":"皑","pinyin":"ái","is_polyphone":false,"all_pinyin":["ái"]},{"hanzi":"皚","pinyin":"ái","is_polyphone":false,"all_pinyin":["ái"]},{"hanzi":"皧","pinyin":"ài","is_polyphone":false,"all_pinyin":["ài"]},{"hanzi":"瞹","pinyin":"ài","is_polyphone":false,"all_pinyin":["ài"]},{"hanzi":"矮","pinyin":"ǎi","is_polyphone":false,"all_pinyin":["ǎi"]},{"hanzi":"砹","pinyin":"ài","is_polyphone":false,"all_pinyin":["ài"]},{"hanzi":"硋","pinyin":"ài","is_polyphone":false,"all_pinyin":["ài"]},{"hanzi":"硙","pinyin":"ái","is_polyphone":true,"all_pinyin":["ái","gài","wèi"]},{"hanzi":"碍","pinyin":"ài","is_polyphone":false,"all_pinyin":["ài"]},{"hanzi":"磑","pinyin":"ái","is_polyphone":true,"all_pinyin":["ái","gài","wèi"]},{"hanzi":"礙","pinyin":"ài","is_polyphone":false,"all_pinyin":["ài"]},{"hanzi":"絠","pinyin":"ǎi","is_polyphone":true,"all_pinyin":["ǎi","gǎi"]},{"hanzi":"艾","pinyin":"ài","is_polyphone":true,"all_pinyin":["ài","yì"]},{"hanzi":"蔼","pinyin":"ǎi","is_polyphone":false,"all_pinyin":["ǎi"]},{"hanzi":"薆","pinyin":"ài","is_polyphone":false,"all_pinyin":["ài"]},{"hanzi":"藹","pinyin":"ǎi","is_polyphone":false,"all_pinyin":["ǎi"]},{"hanzi":"誒","pinyin":"āi","is_polyphone":true,"all_pinyin":["āi","éi","èi","ěi","ēi","xī"]},{"hanzi":"諰","pinyin":"āi","is_polyphone":true,"all_pinyin":["āi","shāi","xǐ"]},{"hanzi":"譪","pinyin":"ǎi","is_polyphone":false,"all_pinyin":["ǎi"]},{"hanzi":"譺","pinyin":"ài","is_polyphone":false,"all_pinyin":["ài"]},{"hanzi":"诶","pinyin":"āi","is_polyphone":true,"all_pinyin":["āi","éi","èi","ěi","ēi","xī"]},{"hanzi":"賹","pinyin":"ài","is_polyphone":true,"all_pinyin":["ài","yì"]},{"hanzi":"躷","pinyin":"ǎi","is_polyphone":false,"all_pinyin":["ǎi"]},{"hanzi":"銰","pinyin":"āi","is_polyphone":false,"all_pinyin":["āi"]},{"hanzi":"鎄","pinyin":"āi","is_polyphone":false,"all_pinyin":["āi"]},{"hanzi":"鑀","pinyin":"ài","is_polyphone":false,"all_pinyin":["ài"]},{"hanzi":"锿","pinyin":"āi","is_polyphone":false,"all_pinyin":["āi"]},{"hanzi":"阨","pinyin":"ài","is_polyphone":true,"all_pinyin":["ài","è"]},{"hanzi":"隑","pinyin":"ái","is_polyphone":true,"all_pinyin":["ái","gāi","qí"]},{"hanzi":"隘","pinyin":"ài","is_polyphone":false,"all_pinyin":["ài"]},{"hanzi":"霭","pinyin":"ǎi","is_polyphone":false,"all_pinyin":["ǎi"]},{"hanzi":"靄","pinyin":"ǎi","is_polyphone":false,"all_pinyin":["ǎi"]},{"hanzi":"靉","pinyin":"ài","is_polyphone":true,"all_pinyin":["ài","yǐ"]},{"hanzi":"餲","pinyin":"ài","is_polyphone":true,"all_pinyin":["ài","hé"]},{"hanzi":"馤","pinyin":"ài","is_polyphone":false,"all_pinyin":["ài"]},{"hanzi":"騃","pinyin":"ái","is_polyphone":true,"all_pinyin":["ái","sì"]},{"hanzi":"鱫","pinyin":"ài","is_polyphone":false,"all_pinyin":["ài"]},{"hanzi":"鴱","pinyin":"ài","is_polyphone":false,"all_pinyin":["ài"]}],"total":81},"execution_time":0.029,"timestamp":1788744856}
{"success":false,"code":400,"message":"缺少pinyin参数,请输入要查询的拼音","data":null,"execution_time":0.004,"timestamp":1788744878}
| 错误代码 | HTTP状态 | 错误信息 | 详细说明 |
|---|---|---|---|
400 |
400 | missing_action | 缺少action参数 |
400 |
400 | missing_text | 缺少text参数 |
|
400 | missing_pinyin | 缺少pinyin参数 |
| 错误代码 | HTTP状态 | 错误信息 | 详细说明 |
|---|---|---|---|
401 | HTTP 401 | 认证失败 | 请求头中缺少 X-API-Key 或 API Key 无效 |
400 | HTTP 400 | 参数错误 | 缺少必要参数(api_id、endpoint_id、method)或必填业务参数缺失 |
404 | HTTP 404 | 资源不存在 | API不存在、已下架或端点不存在 |
403 | HTTP 403 | 未开通 | 您尚未开通此API,请先开通 |
405 | HTTP 405 | 方法不允许 | 请求方法不在端点允许列表中 |
402 | HTTP 402 | 积分不足 | 账户积分不足以调用该API |
500 | HTTP 500 | 服务器内部错误 | 系统异常 |
浙公网安备 33059102000262号