| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| id | string | 是 | 用户唯一标识,可为设备id等具有唯一性的值 | 1828222534 |
| msg | string | 是 | 输入内容,如:开始成语接龙 我接秋高气爽 | 开始成语接龙 |
[
{
"name": "id",
"type": "string",
"required": true,
"description": "用户唯一标识,可为设备id等具有唯一性的值",
"example": "1828222534"
},
{
"name": "msg",
"type": "string",
"required": true,
"description": "输入内容,如:开始成语接龙 我接秋高气爽",
"example": "开始成语接龙"
}
]
{"openapi":"3.1.1","info":{"title":"成语接龙","description":"有趣的成语接龙,你敢和机器人比比谁是成语接龙大师吗?","version":"1.0.0"},"paths":{"/v1/game_cyjl.php":{"get":{"summary":"成语接龙","description":"有趣的成语接龙,你敢和机器人比比谁是成语接龙大师吗?","parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string","example":"1828222534"},"description":"用户唯一标识,可为设备id等具有唯一性的值"},{"name":"msg","in":"query","required":true,"schema":{"type":"string","example":"开始成语接龙"},"description":"输入内容,如:开始成语接龙 我接秋高气爽"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"summary":"成语接龙","description":"有趣的成语接龙,你敢和机器人比比谁是成语接龙大师吗?","parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string","example":"1828222534"},"description":"用户唯一标识,可为设备id等具有唯一性的值"},{"name":"msg","in":"query","required":true,"schema":{"type":"string","example":"开始成语接龙"},"description":"输入内容,如:开始成语接龙 我接秋高气爽"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"servers":[{"url":"http://xiaoapi.cn","description":"当前访问入口(http)"}]}
{
"code": 200,
"data": {
"user": {
"idiom": "城下之盟",
"pinyin": "chéng xià zhī méng",
"meaning": "指在敌方兵临城下时被迫签订的屈服的和约。"
},
"system": {
"idiom": "盟山誓海",
"pinyin": "méng shān shì hǎi",
"meaning": "犹海誓山盟。对着山海盟誓。极言男女相爱,坚贞不渝。"
},
"current_char": "海"
},
"msg": "我接好啦,请继续接龙",
"tips": "慕名API:http://xiaoapi.cn"
}
成语接龙游戏接口,用户输入起始成语或回复系统提供的接龙成语,即可与机器人进行多轮成语接龙对战。适合休闲娱乐、语言学习、亲子互动等场景使用。
/v1/game_cyjl.php
GET / POST
无需密钥
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | string | 是 | 用户唯一标识,可为设备 id 等具有唯一性的值 |
| msg | string | 是 | 输入内容,如:开始成语接龙 我接秋高气爽 |
参数取值说明
msg 支持以「开始成语接龙」开启新游戏,或通过「我接 + 成语」提交接龙答案。{
"code": 200,
"data": {
"user": {
"idiom": "城下之盟",
"pinyin": "chéng xià zhī méng",
"meaning": "指在敌方兵临城下时被迫签订的屈服的和约。"
},
"system": {
"idiom": "盟山誓海",
"pinyin": "méng shān shì hǎi",
"meaning": "犹海誓山盟。对着山海盟誓。极言男女相爱,坚贞不渝。"
},
"current_char": "海"
},
"msg": "我接好啦,请继续接龙",
"tips": "慕名API:http://xiaoapi.cn"
}
| 字段 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码,200 表示成功 |
| data | object | 响应数据对象 |
| data.user | object | 用户输入的成语信息 |
| data.user.idiom | string | 用户输入的成语 |
| data.user.pinyin | string | 用户成语的拼音 |
| data.user.meaning | string | 用户成语的意思解释 |
| data.system | object | 机器人回复的成语信息 |
| data.system.idiom | string | 机器人回复的成语 |
| data.system.pinyin | string | 机器人成语的拼音 |
| data.system.meaning | string | 机器人成语的意思解释 |
| data.current_char | string | 下一轮需要接龙的汉字 |
| msg | string | 接口提示信息 |
| tips | string | 附加提示信息 |
{
"code": 0,
"msg": "未提供调用密钥",
"errcode": 11001
}
| errcode | 含义 |
|---|---|
| 11001 | 未提供调用密钥 |
| 11002 | 密钥错误 |
| 11003 | 密钥已禁用 |
| 11004 | 积分余额不足 |
| 11005 | 请求过于频繁(QPM 限制) |
| 11006 | 接口维护中 |
| 11007 | 接口已禁用 |
| 11008 | 接口不可用 |
| 11009 | 密钥校验暂不可用 |
| 11010 | 积分系统暂不可用 |
| 11011 | 收费接口须提供有效密钥 |
| 11012 | 鉴权方式错误 |
| 11013 | 接口不存在 |
| 11014 | ***地址无效 |
| 11015 | ***地址不允许 |
| 11016 | ***请求失败 |
| 11017 | 服务暂不可用 |
| 11018 | 请求方式不允许 |
| 11019 | 当前IP不在白名单内 |
| 11020 | 启用出口代理须提供有效密钥 |
| 11021 | 未配置可用出口代理 |
| 11022 | 出口代理不可用 |
GET 请求:
curl -G "http://xiaoapi.cn/v1/game_cyjl.php" \
--data-urlencode "id=1828222534" \
--data-urlencode "msg=开始成语接龙"
POST 请求:
curl -X POST "http://xiaoapi.cn/v1/game_cyjl.php" \
-d "id=1828222534" \
-d "msg=我接秋高气爽"
// PHP
$url = "http://xiaoapi.cn/v1/game_cyjl.php";
$params = array(
"id" => "1828222534",
"msg" => "开始成语接龙"
);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url . "?" . http_build_query($params));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
id),建议使用设备IMEI、UUID或服务器生成的会话ID,确保不同用户或会话之间数据隔离,避免标识泄露至前端或日志。msg 支持“开始成语接龙”触发游戏,也支持直接发送接龙内容(如“我接秋高气爽”)。发送接龙时须包含有效成语,无效输入将返回错误提示。code=200 表示正常,游戏状态依赖 current_char 字段(上一次接龙的尾字),客户端需自行维护上下文会话;code 非 200 时需按错误码分支处理异常。id 中使用手机号、邮箱等可识别个人身份的信息,建议使用哈希或临时Token替代。curl -s "https://xiaoapi.cn/v1/game_cyjl
// 结果将在此处显示