接口简介
随机一言API,可输出心灵鸡汤、至理名言、人生哲理等各类文本内容,适用于评论系统、心情展示、签名生成等场景。接口完全免费,支持GET/POST请求方式。
接口核心参数
| 参数 | 必填 | 说明 |
| id | 是 | 用户中心的数字ID |
| key | 是 | 用户中心通讯秘钥 |
注意:请前往官网注册获取专属ID和KEY,避免使用公共示例密钥(88888888)导致请求受限。
返回数据格式
json
复制
{ "code": 200, // 状态码(200成功/400错误) "msg": "获得成功的人,肯定在人生某个阶段做出了一个重大的决断。" // 返回内容 }
调用示例(PHP)
php
复制
<?php // 用户凭证(替换为实际值) $user_id = "你的ID"; $api_key = "你的KEY"; // 构建请求URL $api_url = "https://cn.apihz.cn/api/yiyan/api.php?id=$user_id&key=$api_key"; // 发送GET请求 $response = file_get_contents($api_url); $data = json_decode($response, true); // 处理结果 if ($data['code'] == 200) { echo "随机一言:".$data['msg']; } else { echo "请求失败:".$data['msg']; } ?>
调用示例(Python)
python
运行
复制
import requests # 用户凭证(替换为实际值) user_id = "你的ID" api_key = "你的KEY" # 构建请求参数 params = { 'id': user_id, 'key': api_key } try: # 发送GET请求 response = requests.get('https://cn.apihz.cn/api/yiyan/api.php', params=params) data = response.json() # 处理结果 if data['code'] == 200: print("随机一言:" + data['msg']) else: print("请求失败:" + data['msg']) except Exception as e: print("请求异常:" + str(e))
使用注意事项
- 密钥安全:请妥善保管自己的KEY,避免泄露
- 频率限制:公共KEY共享每分钟调用频次,私有KEY独享频率限制
- 错误处理:
400状态码:参数错误或密钥无效- 连接超时:检查网络或重试
- 内容版权:所有内容版权归接口盒子所有
应用场景
✅ 评论区随机展示
✅ 网站底部签名
✅ 每日鸡汤推送
✅ 心情日记生成器
✅ 学习卡片内容源
通过简单的API调用,即可为您的应用注入丰富的人文元素,让用户每次访问都能获得新的感悟与启发。