← 返回接口市场
GET
随机一言
● 全免费
文字类
hitokoto
📥 请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| apikey | string | 是 | 用户密钥，在个人中心获取 |
| type | string | 否 | 句子类型: 动画/漫画/游戏/文学/原创/网络/其他/影视/诗词/网易云/哲学，不传则随机 |
📤 返回示例
{
"code": 1,
"msg": "请求成功",
"time": 1782040315,
"data": {
"content": "世界は美しくなんかない、そしてそれ故に美しい。",
"type": "random"
}
}
📋 返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| content | string | 句子内容 |
| type | string | 类型: random(随机)/动画/漫画/游戏/文学/原创/网络/其他/影视/诗词/网易云/哲学 |
⚠ 错误码说明
| 状态码 | 说明 |
|---|---|
| 200 | 请求成功 |
| 400 | 缺少必要参数 apikey |
| 401 | apikey 无效 |
| 402 | 余额不足 |
| 403 | 账号禁用 / VIP等级不够 / 无权限 |
| 404 | 接口不存在 |
| 429 | 今日调用次数已用完 |
💻 调用示例代码
# cURL
curl "https://webapi.com/api/hitokoto?apikey=你的apikey"
# Python
import requests
resp = requests.get("https://webapi.com/api/hitokoto", params={"apikey": "你的apikey"})
print(resp.json())
# JavaScript
fetch("https://webapi.com/api/hitokoto?apikey=你的apikey")
.then(r => r.json())
.then(data => console.log(data));
# PHP
$url = "https://webapi.com/api/hitokoto?apikey=你的apikey";
$result = file_get_contents($url);
print_r(json_decode($result, true));
💰 定价与限额
| 会员等级 | 单价 | 次数限制 |
|---|---|---|
| 注册用户 VIP0 | 免费 | 1000 次 |
| 普通会员 VIP1 | 免费 | 5000 次 |
| 高级会员 VIP2 | 免费 | 10000 次 |
| 顶级会员 VIP3 | 免费 | 无限制 |