当前位置：网站首页>一言（ヒトコト）Hitokoto API

一言（ヒトコト）Hitokoto API

2022-08-11 01:56:00 【51CTO】

『想要成为无论多么悲伤的时候，也能够漂亮微笑的人吧。』

Hitokoto API

更新：2014.02.22

问题/反馈：api # hitokoto.us

数据获取：[ 数据获取 ]

调用举例：[ JavaScript + HTML （同步） ] [ JavaScript + JSON CallBack （同步+异步调用两种） ]

点此看看哪些网站正在使用API

数据获取

请求地址 http://api.hitokoto.us/rand
SSL https://api.hitokoto.us:214/rand
请求方式GET
请求参数
cat返回指定分类的一句话，如果为空则返回任意分类的一言。若请求参数包含uid，则cat对应cid
charset字符集，支持gbk/utf-8，默认为utf-8
length返回一句话的长度限制，超出则打断并添加省略号
encode数据格式，对应如下
json默认为此，返回JSON格式数据
xml返回XML格式数据
js返回函数名为hitokoto的JavaScript脚本，用于同步调用
jsc返回指定CallBack函数名的JavaScript脚本，可用于异步调用
fun用于异步调用时，指定CallBack的函数名，不可包含特殊字符
uid获取“我的一言”
mix同时在系统收录的“一言”和获取“我的一言”中随机，若需指定用户分类请使用ucat参数
ucat配合mix参数使用，用于指定用户分类CID
实例
请求 http://api.hitokoto.us/rand?cat=a&charset=utf-8
返回
{
    id : "1318722783000",
    hitokoto : "呐，知道么，樱花飘落的速度，是每秒五厘米哦~",
    cat : "a",
    catname : "动画",
    author : "烤飞鱼的土豆",
    source : "秒速五厘米",
    like : "5",
    date : "2011.10.15 23:53:03"
}
参数说明
id一言的ID，可以通过 http://hitokoto.us/view/{ID}.html 查看指定条目
hitokoto一言的正文部分，不包含前后引号
cat分类，对应关系如下
aAnime - 动画
bComic - 漫画
cGame - 游戏
dNovel - 小说
e原创
f来自网络
g其他
catname分类cat对应的名字
author一言的投稿人
source一言的出处，可能为空
like一言的喜欢次数
date一言的投稿日期

调用举例 - JavaScript + HTML

脚本地址 http://api.hitokoto.us/rand?encode=js
SSL https://api.hitokoto.us:214/rand?encode=js
使用方法
1. 将下面这段代码放入HTML页面的head标签内
<script type="text/javascript" src="http://api.hitokoto.us/rand?encode=js&charset=utf-8"></script>

2. 将下面这段代码放入页面内需要展示一句话的位置即可
<div ><script>hitokoto()</script></div>

该脚本实质为document.write的脚本。

调用举例 - JavaScript + JSON CallBack

脚本地址 http://api.hitokoto.us/rand?encode=jsc
SSL https://api.hitokoto.us:214/rand?encode=jsc
使用方法
同步
1. 将下面这段代码放入HTML页面的head标签内
<script type="text/javascript" src="http://api.hitokoto.us/rand?encode=jsc&fun=sync"></script>

该脚本会与页面同步加载，加载成功后会自动调用指定的函数名，本实例中为sync，并将数据传递给该函数，提前定义该函数即刻达到接收并处理一言数据的目的。
异步
1. 将下面这段代码放入HTML页面的最底部
<script type="text/javascript">setTimeout(function(){var hjs=document.createElement('script');hjs.setAttribute('src','http://api.hitokoto.us/rand?encode=jsc&fun=async');document.body.appendChild(hjs);},100);</script>

通过setTimeout加载JavaScript脚本达到异步加载js脚本的目的，加载成功后会自动调用指定的函数名，本实例中为async，并将数据传递给该函数，提前定义该函数即刻达到接收并处理一言数据的目的。