Hitokoto API


更新:2011.11.03
问题/反馈:api # hitokoto.us
索引:数据获取:[ JSON ] [ XML ] 脚本:[ JavaScript ] [ JavaScript + JSON Callback ]
应用实例:http://bbs.comicdd.com


JSON


请求地址http://api.hitokoto.us/rand
请求方式GET
请求参数cat => 返回指定分类的一句话,如果为空则返回任意分类的一句话。
可指定多个分类,使用","分割。例:?cat=a,b,c
若请求参数包含uid,则cat对应CID
charset => 字符集,支持gbk/utf-8,默认为utf-8
uid => 获取“我的一句话”
实例
请求http://api.hitokoto.us/rand?cat=a&charset=utf-8
返回{
"id":"1318722783",
"hitokoto":"呐,知道么,樱花飘落的速度,是每秒五厘米哦~",
"cat":"a",
"catname":"动画",
"author":"烤飞鱼的土豆",
"source":"秒速五厘米",
"like":"5",
"date":"2011.10.15 23:53:03"
}
参数说明
id一句话的ID,可以通过 http://hitokoto.us/view/{ID} 查看指定条目
hitokoto一句话的正文部分,不包含前后引号
cat分类,对应关系如下
"a" => "Anime - 动画"
"b" => "Comic - 漫画"
"c" => "Game - 游戏"
"d" => "Novel - 小说"
"e" => "原创"
"f" => "来自网络"
"g" => "其他"
catname分类cat对应的名字
author一句话的投稿人
source一句话的出处,可能为空
like一句话的喜欢次数
date一句话的投稿日期



XML


请求地址http://api.hitokoto.us/rand?encode=xml
请求方式GET
请求参数cat => 返回指定分类的一句话,如果为空则返回任意分类的一句话。
可指定多个分类,使用","分割。例:?cat=a,b,c
若请求参数包含uid,则cat对应CID
charset => 字符集,支持gbk/utf-8,默认为utf-8
uid => 获取“我的一句话”
实例
请求http://api.hitokoto.us/rand?cat=a&encode=xml&charset=utf-8
返回<?xml version="1.0" encoding="utf-8"?>
<result>
    <id>1318722783</id>
    <hitokoto><![CDATA[呐,知道么,樱花飘落的速度,是每秒五厘米哦~]]></hitokoto>
    <catname>a</cat>
    <cat><![CDATA[动画]]></catname>
    <author><![CDATA[烤飞鱼的土豆]]></author>
    <source><![CDATA[秒速五厘米]]></source>
    <like>6</like>
    <date><![CDATA[2011.10.15 23:53:03]]></date>
</result>
参数说明
id一句话的ID,可以通过 http://hitokoto.us/view/{ID} 查看指定条目
hitokoto一句话的正文部分,不包含前后引号
cat分类,对应关系如下
"a" => "Anime - 动画"
"b" => "Comic - 漫画"
"c" => "Game - 游戏"
"d" => "Novel - 小说"
"e" => "原创"
"f" => "来自网络"
"g" => "其他"
catname分类cat对应的名字
author一句话的投稿人
source一句话的出处,可能为空
like一句话的喜欢次数
date一句话的投稿日期



JavaScript


脚本地址http://api.hitokoto.us/rand?encode=js
请求参数cat => 返回指定分类的一句话,如果为空则返回任意分类的一句话。
可指定多个分类,使用","分割。例:?cat=a,b,c
若请求参数包含uid,则cat对应CID
charset => 字符集,支持gbk/utf-8,默认为utf-8
uid => 获取“我的一句话”
使用方法
<script type="text/javascript" src="http://api.hitokoto.us/rand?encode=js&charset=utf-8"></script>
使用时将此段代码放入HTML页面的head标签内
<div id="hitokoto"><script>hitokoto()</script></div>
然后将这段代码放入页面内需要展示一句话的位置即可
参数说明
cat分类,对应关系如下
"a" => "Anime - 动画"
"b" => "Comic - 漫画"
"c" => "Game - 游戏"
"d" => "Novel - 小说"
"e" => "原创"
"f" => "来自网络"
"g" => "其他"



JavaScript + JSON Callback


脚本地址http://api.hitokoto.us/rand?encode=jsc
请求参数cat => 返回指定分类的一句话,如果为空则返回任意分类的一句话。
可指定多个分类,使用","分割。例:?cat=a,b,c
若请求参数包含uid,则cat对应CID
fun => Callback对应的函数名称,可以为空,默认为hitokoto
charset => 字符集,支持gbk/utf-8,默认为utf-8
uid => 获取“我的一句话”
使用方法
<script type="text/javascript" src="http://api.hitokoto.us/rand?encode=jsc&charset=utf-8"></script>
使用时将此段代码放入HTML页面的head标签内即可
实例
请求http://api.hitokoto.us/rand?cat=a&encode=jsc&fun=tesuto
返回 tesuto(
{"id":"1318722783","hitokoto":"\u5450\uff0c\u77e5\u9053\u4e48\uff0c\u6a31\u82b1\u98d8\u843d\u7684\u901f\u5ea6\uff0c\u662f\u6bcf\u79d2\u4e94\u5398\u7c73\u54e6~","cat":"a","author":"\u70e4\u98de\u9c7c\u7684\u571f\u8c46","source":"\u79d2\u901f\u4e94\u5398\u7c73","like":"6","date":"2011.10.15 23:53:03"}
);
参数说明
id一句话的ID,可以通过 http://hitokoto.us/view/{ID} 查看指定条目
hitokoto一句话的正文部分,不包含前后引号
cat分类,对应关系如下
"a" => "Anime - 动画"
"b" => "Comic - 漫画"
"c" => "Game - 游戏"
"d" => "Novel - 小说"
"e" => "原创"
"f" => "来自网络"
"g" => "其他"
catname分类cat对应的名字
author一句话的投稿人
source一句话的出处,可能为空
like一句话的喜欢次数
date一句话的投稿日期






首页 投稿 登录 注册
我知道了