Hitokoto API
更新：.02.22
问题/反馈：api # hitokoto.us
数据获取：[ 数据获取 ]
调用举例：[ JavaScript + HTML （同步） ] [ JavaScript + JSON CallBack （同步+异步调用两种） ]
点此看看哪些网站正在使用API
数据获取
请求地址http://api.hitokoto.us/randSSLhttps://api.hitokoto.us:214/rand请求方式GET请求参数cat返回指定分类的一句话，如果为空则返回任意分类的一言。若请求参数包含uid，则cat对应cidcharset字符集，支持gbk/utf-8，默认为utf-8length返回一句话的长度限制，超出则打断并添加省略号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 : ".10.1523: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=jsSSLhttps://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 id="hitokoto"><script>hitokoto()</script></div>
该脚本实质为document.write的脚本。
调用举例 - JavaScript + JSON CallBack
脚本地址http://api.hitokoto.us/rand?encode=jscSSLhttps://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，并将数据传递给该函数，提前定义该函数即刻达到接收并处理一言数据的目的。
(ヒトコト)一个挺有趣的东西！作为一个动漫宅 游戏宅来说还是一个挺有趣的接口！banner上面就是...
如果觉得《(ヒトコト)一个挺有趣的东西！作为一个动漫宅 游戏宅来说还是一个挺有趣的接口！bann》对你有帮助，请点赞、收藏，并留下你的观点哦！
