『少女祈祷中...』

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,并将数据传递给该函数,提前定义该函数即刻达到接收并处理一言数据的目的。







goTop
NodeJs Hitokoto.us 目前每秒收到约 65 次请求。+ Rouwan.
Copyright © 2011,2012,2013,2014 Hitokoto.us & Sai.   Email: hitokoto # hitokoto.us
关闭

投稿我的一言个人设置退出登录