一言（ヒトコト）Hitokoto API

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

Hitokoto API

更新：2014.02.22

问题/反馈：api # hitokoto.us

数据获取：[ 数据获取 ]

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

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

数据获取

• 请求地址http://api.hitokoto.us/rand
• SSLhttps://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
• SSLhttps://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=jsc
• SSLhttps://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，并将数据传递给该函数，提前定义该函数即刻达到接收并处理一言数据的目的。

网址：http://hitokoto.us/api.html

迷失在幽谷中的鸟儿，独自飞翔在这偌大的天地间，却不知自己该飞往何方……