随机语录
随机语录大全,包含:经典,动漫,恋爱,鼓励,孤独,搞笑,友情,歌词等等
接口信息
GET
api.vsaa.cn/api/quote/index.php
Method
GET
分类
其他
Calls
13
KEY
无需 KEY
计费
免费
QPM
180/MIN
鉴权方式
无需密钥
作者
请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| type | string | 否 | 分类: 经典,动漫,恋爱,鼓励,孤独,搞笑,友情,歌词 | 经典 |
[
{
"name": "type",
"type": "string",
"required": false,
"description": "分类: 经典,动漫,恋爱,鼓励,孤独,搞笑,友情,歌词",
"example": "经典"
}
]
返回示例
{
"code": 200,
"text": [
"夜来南风起,小麦覆陇黄。"
],
"author": [
"白居易"
]
}
详细文档
随机语录
接口说明
提供随机语录查询服务,涵盖经典、动漫、恋爱、鼓励、孤独、搞笑、友情、歌词等多个分类,供开发者在应用中随机展示语录内容。
调用地址
/api/quote/index.php
请求方式
GET
鉴权说明
无需密钥
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| type | string | 否 | 语录分类,支持值:经典、动漫、恋爱、鼓励、孤独、搞笑、友情、歌词 |
成功响应示例
{
"code": 200,
"text": [
"夜来南风起,小麦覆陇黄。"
],
"author": [
"白居易"
]
}
响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码,200 表示成功 |
| text | string[] | 语录文本列表,每次随机返回一条 |
| author | string[] | 语录作者列表,与 text 一一对应 |
错误响应示例
{
"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 | 出口代理不可用 |
调用示例
终端 curl(bash)
curl "https://api.example.com/api/quote/index.php?type=经典"
PHP
注意事项
- 本接口无需密钥,但仍建议通过 HTTPS 调用,防止参数在传输过程中被劫持或篡改。
- 频率限制为每分钟约 180 次,超出限制将返回错误响应,请合理控制调用间隔,避免触发限流。
type参数为可选分类筛选,支持的值包括:经典、动漫、恋爱、鼓励、孤独、搞笑、友情、歌词。填写时请注意使用完整中文名称,拼写错误或传入未支持分类时将默认返回全量随机语录。- 接口返回的
text和author字段为数组格式,单次调用仅包含一条语录,客户端解析时建议直接取第一个元素。 - 本接口为免费服务,调用方不得用于恶意刷量或批量爬取,违规使用将被临时封禁。
快速上手
curl -s 'https://api.example.com/api/quote/index.php?type=经典'
在线测试
请求地址
api.vsaa.cn/api/quote/index.php
参数
Response
等待中
// 结果将在此处显示