随机一言v1 API 文档

接口简介

随机一言API是一个本地随机一言接口，提供优美的句子供网站展示、签名档、博客装饰等场景使用。通过本接口，您可以随机获取一条句子，也可以根据分类获取句子。

请求说明

请求地址：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平台地址

返回示例

{
    "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

cURL命令示例

curl -X GET "https://api.xunjinlu.fun/api/yiyan/v1.php?key=YOUR_API_KEY&c=1" -H "accept: application/json"

JavaScript (fetch) 示例

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 示例

$.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) 示例

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) 示例

$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) 示例

注意：以上示例中的YOUR_API_KEY需要替换为您实际获取的接口访问密钥。