随机一言v1

# 一言API接口文档 (v1) ## 接口概述 一言API是一个本地随机一言接口，从本地数据文件中随机获取一条优美的句子。支持按分类获取或随机获取，适用于网站展示、签名档、博客装饰等场景。 ## 接口地址 ``` GET/POST https://api.xunjinlu.fun/api/yiyan/v1.php ``` ## 请求方式 - `GET` - 通过URL参数传递 - `POST` - 通过表单或JSON格式传递 ## 请求参数 ### 参数说明 | 参数名 | 类型 | 必填 | 说明 | |--------|------|------|------| | c | int | 否 | 分类序号（1-12），不传则随机返回 | ### JSON 请求参数示例 ```json [ { "name": "c", "type": "integer", "required": false, "description": "分类序号：1动画 2漫画 3游戏 4文学 5原创 6来自网络 7其他 8影视 9诗词 10网易云 11哲学 12抖机灵，不传则随机返回", "example": 4 } ] ``` #### 请求参数详细说明 | 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | `c` | integer | 否 | 分类序号，范围为 1-12，不传则随机返回 | **分类映射表：** | 序号 | 分类 | 序号 | 分类 | |------|------|------|------| | `1` | 动画 | `7` | 其他 | | `2` | 漫画 | `8` | 影视 | | `3` | 游戏 | `9` | 诗词 | | `4` | 文学 | `10` | 网易云 | | `5` | 原创 | `11` | 哲学 | | `6` | 来自网络 | `12` | 抖机灵 | #### 请求示例 **随机获取一言：** ```json {} ``` **指定分类获取一言（文学类）：** ```json { "c": 4 } ``` ## 分类参数表 | 序号 | 分类名称 | 文件名 | 说明 | |------|----------|--------|------| | 1 | 动画 | 动画.txt | 动画作品中的经典台词 | | 2 | 漫画 | 漫画.txt | 漫画作品中的经典台词 | | 3 | 游戏 | 游戏.txt | 游戏中的经典语录 | | 4 | 文学 | 文学.txt | 文学作品中的优美句子 | | 5 | 原创 | 原创.txt | 原创作品 | | 6 | 来自网络 | 来自网络.txt | 网络流行语 | | 7 | 其他 | 其他.txt | 其他类型 | | 8 | 影视 | 影视.txt | 影视作品中的经典台词 | | 9 | 诗词 | 诗词.txt | 古诗词名句 | | 10 | 网易云 | 网易云.txt | 网易云音乐热评 | | 11 | 哲学 | 哲学.txt | 哲学名言 | | 12 | 抖机灵 | 抖机灵.txt | 幽默段子 | ## 响应参数 ### 成功响应 (指定分类) ```json { "code": 200, "msg": "success", "data": { "id": "4671", "content": "我不借助别人的力量就没办法跟仰慕的人聊天吗？", "source": "未知", "category_id": 1, "category_name": "动画" }, "api_info": { "developer": "尋鯨錄", "blog": "https://www.xunjinlu.fun", "api_platform": "https://api.xunjinlu.fun" } } ``` ### 成功响应 (随机获取) ```json { "code": 200, "msg": "success (random)", "data": { "id": "8145", "content": "若今后没有炬火，你便是唯一的光。", "source": "鲁迅", "category_id": 4, "category_name": "文学" }, "api_info": { "developer": "尋鯨錄", "blog": "https://www.xunjinlu.fun", "api_platform": "https://api.xunjinlu.fun" } } ``` ### 错误响应 (无效分类) ```json { "code": 400, "msg": "分类序号无效，有效范围为1-12", "data": { "categories": [ {"id": 1, "name": "动画", "file": "动画.txt", "count": 120}, {"id": 2, "name": "漫画", "file": "漫画.txt", "count": 85}, ... ] }, "api_info": { "developer": "尋鯨錄", "blog": "https://www.xunjinlu.fun", "api_platform": "https://api.xunjinlu.fun" } } ``` ### 错误响应 (服务器错误) ```json { "code": 500, "msg": "获取一言数据失败，数据文件可能不存在或为空", "data": null, "api_info": { "developer": "尋鯨錄", "blog": "https://www.xunjinlu.fun", "api_platform": "https://api.xunjinlu.fun" } } ``` ## 响应字段说明 | 字段 | 类型 | 说明 | |------|------|------| | code | int | 状态码，200为成功，400为参数错误，500为服务器错误 | | msg | string | 状态描述信息 | | data | object/null | 返回的一言数据 | | data.id | string | 一言的唯一标识ID | | data.content | string | 一言内容 | | data.source | string | 一言的来源/作者 | | data.category_id | int | 分类序号（1-12） | | data.category_name | string | 分类名称 | | api_info | object | API开发者信息 | | api_info.developer | string | 开发者名称 | | api_info.blog | string | 开发者博客地址 | | api_info.api_platform | string | API平台地址 | ## 注意事项 1. **跨域支持**：接口已配置CORS，支持跨域访问 2. **数据随机**：每次请求都会从对应分类中随机返回一条数据 3. **本地数据**：所有数据均来自本地文件，无需依赖外部API 4. **分类统计**：当传入无效分类时，接口会返回所有可用分类列表 5. **编码格式**：接口返回UTF-8编码的JSON数据 ## 更新日志 | 版本 | 日期 | 说明 | |------|------|------| | v1.0.0 | 2026-05-02 | 初始版本，支持12个分类的一言随机获取 | ## 开发者信息 - **开发者**：尋鯨錄 - **博客**：[https://www.xunjinlu.fun](https://www.xunjinlu.fun) - **API平台**：[https://api.xunjinlu.fun](https://api.xunjinlu.fun)

# 随机一言v1 API 文档 ## 接口简介 随机一言API是一个本地随机一言接口，提供优美的句子供网站展示、签名档、博客装饰等场景使用。通过本接口，您可以随机获取一条句子，也可以根据分类获取句子。 ## 请求说明 - **请求地址**：[https://api.xunjinlu.fun/api/yiyan/v1.php](https://api.xunjinlu.fun/api/yiyan/v1.php) - **请求方法**：GET - **请求头**：无特殊要求，根据实际情况添加必要的请求头。 ## 请求参数 | 参数名 | 类型 | 是否必填 | 说明 | | --- | --- | --- | --- | | key | string | 是 | 接口访问密钥，开启密钥访问时必填 | | c | integer | 否 | 分类序号，1动画 2漫画 3游戏 4文学 5原创 6来自网络 7其他 8影视 9诗词 10网易云 11哲学 12抖机灵，不传则随机返回 | ## 返回参数 | 参数名 | 类型 | 说明 | | --- | --- | --- | | code | integer | 状态码，200表示成功 | | msg | string | 状态消息，success表示成功 | | data | object | 返回的具体数据 | | - id | string | 句子的唯一标识 | | - content | string | 句子内容 | | - source | string | 句子来源 | | - category_id | integer | 分类ID | | - category_name | string | 分类名称 | | api_info | object | API信息 | | - developer | string | 开发者信息 | | - blog | string | 开发者博客地址 | | - api_platform | string | API平台地址 | ## 返回示例 ```json { "code": 200, "msg": "success", "data": { "id": "4671", "content": "我不借助别人的力量就没办法跟仰慕的人聊天吗？", "source": "未知", "category_id": 1, "category_name": "动画" }, "api_info": { "developer": "尋鯨錄", "blog": "https://www.xunjinlu.fun", "api_platform": "https://api.xunjinlu.fun" } } ``` ## 错误码说明 - 200：成功 - 其他错误码：根据实际情况返回，含义请参考返回参数中的`msg`字段。 ## 调用示例 ### 直接访问链接 [https://api.xunjinlu.fun/api/yiyan/v1.php?key=YOUR_API_KEY&c=1](https://api.xunjinlu.fun/api/yiyan/v1.php?key=YOUR_API_KEY&c=1) ### cURL命令示例 ```bash curl -X GET "https://api.xunjinlu.fun/api/yiyan/v1.php?key=YOUR_API_KEY&c=1" -H "accept: application/json" ``` ### JavaScript (fetch) 示例 ```javascript fetch('https://api.xunjinlu.fun/api/yiyan/v1.php?key=YOUR_API_KEY&c=1') .then(response => response.json()) .then(data => console.log(data)) .catch(error => console.error('Error:', error)); ``` ### jQuery AJAX 示例 ```javascript $.ajax({ url: 'https://api.xunjinlu.fun/api/yiyan/v1.php?key=YOUR_API_KEY&c=1', type: 'GET', dataType: 'json', success: function(data) { console.log(data); }, error: function(error) { console.error('Error:', error); } }); ``` ### Python (requests) 示例 ```python import requests url = 'https://api.xunjinlu.fun/api/yiyan/v1.php?key=YOUR_API_KEY&c=1' response = requests.get(url) data = response.json() print(data) ``` ### PHP (curl) 示例 ```php $curl = curl_init(); curl_setopt($curl, CURLOPT_URL, "https://api.xunjinlu.fun/api/yiyan/v1.php?key=YOUR_API_KEY&c=1"); curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1); curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json')); $response = curl_exec($curl); curl_close($curl); echo $response; ``` ### HTML (iframe) 示例 ```html ``` 注意：以上示例中的`YOUR_API_KEY`需要替换为您实际获取的接口访问密钥。