简单易用的API,满足各种开发需求
支持JSON、纯文本和HTML格式返回,适应不同场景需求
内置CORS支持,可直接在前端JavaScript中调用
提供JavaScript、PHP、Python等多种语言调用示例
轻量级设计,响应快速,适合各种规模的项目
详细的API接口说明和参数介绍
https://api.baigei.cc/api.php
从数据库随机获取一条一言内容。
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
action |
string | 否 | get | 操作类型,固定值为 get |
format |
string | 否 | json | 返回格式:json, text, html |
encode |
string | 否 | unicode | 编码方式:unicode, plain |
callback |
string | 否 | - | JSONP回调函数名 |
{
"code": 200,
"msg": "success",
"data": "「你好,世界♪」"
}
https://api.baigei.cc/api.php?action=count
获取数据库中一言的总数。
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
action |
string | 是 | - | 操作类型,固定值为 count |
format |
string | 否 | json | 返回格式:json, text, html |
callback |
string | 否 | - | JSONP回调函数名 |
{
"code": 200,
"msg": "success",
"data": 33550336
}
获取随机一言(JSON格式):
GET https://api.baigei.cc/api.php
获取纯文本内容:
GET https://api.baigei.cc/api.php?format=text
获取HTML格式内容:
GET https://api.baigei.cc/api.php?format=html
跨域JSONP调用:
GET https://api.baigei.cc/api.php?callback=myCallback
在线测试API接口,实时查看返回结果
https://api.baigei.cc/api.php?action=get&format=json
多种编程语言的API调用示例
// 使用 Fetch API 获取随机一言
fetch('https://api.baigei.cc/api.php')
.then(response => response.json())
.then(data => {
console.log('获取的一言:', data.data);
document.getElementById('hitokoto').innerText = data.data;
})
.catch(error => console.error('错误:', error));
// 获取纯文本格式的一言
fetch('https://api.baigei.cc/api.php?format=text')
.then(response => response.text())
.then(text => {
console.log('获取的一言:', text);
document.getElementById('hitokoto').innerText = text;
});
// 获取一言总数
fetch('https://api.baigei.cc/api.php?action=count')
.then(response => response.json())
.then(data => {
console.log('一言总数:', data.data);
});
<?php
// 获取随机一言(文本格式)
$hitokoto = file_get_contents('https://api.baigei.cc/api.php?format=text');
echo $hitokoto;
// 获取随机一言(JSON格式)
$data = json_decode(file_get_contents('https://api.baigei.cc/api.php'), true);
echo $data['data'];
// 获取一言总数
$count_data = json_decode(file_get_contents('https://api.baigei.cc/api.php?action=count'), true);
echo "总共有 " . $count_data['data'] . " 条一言";
// 使用cURL获取
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.baigei.cc/api.php?format=text');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$hitokoto = curl_exec($ch);
curl_close($ch);
echo $hitokoto;
?>
import requests
# 获取随机一言(文本格式)
response = requests.get('https://api.baigei.cc/api.php?format=text')
hitokoto = response.text
print(hitokoto)
# 获取随机一言(JSON格式)
response = requests.get('https://api.baigei.cc/api.php')
data = response.json()
print(data['data'])
# 获取一言总数
response = requests.get('https://api.baigei.cc/api.php?action=count')
data = response.json()
print(f"总共有 {data['data']} 条一言")
// 获取随机一言(JSON格式)
$.getJSON('https://api.baigei.cc/api.php', function(data) {
$('#hitokoto').text(data.data);
});
// 获取随机一言(文本格式)
$.get('https://api.baigei.cc/api.php?format=text', function(data) {
$('#hitokoto').text(data);
});
// 获取一言总数
$.getJSON('https://api.baigei.cc/api.php?action=count', function(data) {
$('#count').text('总共有 ' + data.data + ' 条一言');
});
// 使用JSONP跨域调用
$.ajax({
url: 'https://api.baigei.cc/api.php?callback=?',
dataType: 'jsonp',
success: function(data) {
$('#hitokoto').text(data.data);
}
});
<div id="app">
<p>{{ hitokoto }}</p>
<p>总共有 {{ count }} 条一言</p>
<button @click="getHitokoto">获取一言</button>
</div>
<script src="https://cdn.jsdelivr.net/npm/vue@2.6.14/dist/vue.js"></script>
<script>
new Vue({
el: '#app',
data: {
hitokoto: '加载中...',
count: 0
},
mounted() {
this.getHitokoto();
this.getCount();
},
methods: {
getHitokoto() {
fetch('https://api.baigei.cc/api.php?format=text')
.then(response => response.text())
.then(data => {
this.hitokoto = data;
});
},
getCount() {
fetch('https://api.baigei.cc/api.php?action=count')
.then(response => response.json())
.then(data => {
this.count = data.data;
});
}
}
});
</script>