一言API

简洁、高效的随机一言API,为您的网站和应用提供优美的一言内容。

API状态:运行正常
立即测试 查看示例

API端点示例
GET https://api.baigei.cc/api.php?action=get&format=json
{
  "code": 200,
  "msg": "success",
  "data": "「你好,世界♪」"
}

主要特性

简单易用的API,满足各种开发需求

多格式支持

支持JSON、纯文本和HTML格式返回,适应不同场景需求

跨域支持

内置CORS支持,可直接在前端JavaScript中调用

多语言示例

提供JavaScript、PHP、Python等多种语言调用示例

稳定可靠

轻量级设计,响应快速,适合各种规模的项目

API文档

详细的API接口说明和参数介绍

获取随机一言
GET https://api.baigei.cc/api.php

从数据库随机获取一条一言内容。

请求参数
参数名 类型 必填 默认值 说明
action string get 操作类型,固定值为 get
format string json 返回格式:json, text, html
encode string unicode 编码方式:unicode, plain
callback string - JSONP回调函数名
响应示例 (JSON格式)
{
  "code": 200,
  "msg": "success",
  "data": "「你好,世界♪」"
}
获取一言总数
GET https://api.baigei.cc/api.php?action=count

获取数据库中一言的总数。

请求参数
参数名 类型 必填 默认值 说明
action string - 操作类型,固定值为 count
format string json 返回格式:json, text, html
callback string - JSONP回调函数名
响应示例 (JSON格式)
{
  "code": 200,
  "msg": "success",
  "data": 33550336
}
快速开始
基础调用

获取随机一言(JSON格式):

GET https://api.baigei.cc/api.php
纯文本格式

获取纯文本内容:

GET https://api.baigei.cc/api.php?format=text
HTML格式

获取HTML格式内容:

GET https://api.baigei.cc/api.php?format=html
JSONP调用

跨域JSONP调用:

GET https://api.baigei.cc/api.php?callback=myCallback
响应状态码
  • 200 请求成功
  • 400 无效操作
  • 404 未找到内容
  • 500 服务器内部错误

实时API测试

在线测试API接口,实时查看返回结果

请求配置
API请求URL
https://api.baigei.cc/api.php?action=get&format=json
响应结果
点击"发送请求"按钮测试API...

代码示例

多种编程语言的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>