我们希望通过一言,链接大家对各方文字的美好记忆,伴你踩碎迷茫,走过时光。
什么是一言
相信大家都有或曾经有过自己的摘抄本。「一言」就好似一个公开的摘抄本,我们在此记录那些让人感怀的,让人振奋的,让人感动的,让人一眼就有所感触的短句,并通过公共 API 的形式使你能够在自己的项目中调用它们。
我们希望通过一言,链接大家对各方文字的美好记忆,伴你踩碎迷茫,走过时光。
如果你不是开发者,只是想在自己的设备上看到「一言」,请移步文末的「谁在使用一言?」部分。
调用方法
获取数据
出于安全考虑,我们仅支持通过 HTTPS 方法调用 API。
以下所有参数均仅适用于以 GET 方式请求地址: https://api.lwl12.com/hitokoto/v1
charset
: 字符集,支持gbk/utf-8,默认为utf-8encode
: 数据格式,分为js
\json
\realjson
三种js
返回函数名为lwlhitokoto
的 JavaScript 脚本,该脚本使用document.write()
函数显示一言json
返回函数名为echokoto
的 JSONP 数据realjson
返回标准 Json 数据
响应数据
当您请求标准 Json 数据时,API 会返回以下内容:
text
: 一言主体文本author
: 一言在原出处中的作者source
: 一言的来源
请注意,由于数据收集难度很大,并非所有数据都包含 author / source ,请注意在您的程序中判断这两个值为空的情况。
我们假设现在有一作品 A,其中某一段这样写道:
友人B:看呀,这个一言 API 多么好用!
则当我们收录后,返回的数据就会是这样:
text
: 看呀,这个一言 API 多么好用!author
: 友人Bsource
: 《A》
下面是实际请求一次 https://api.lwl12.com/hitokoto/v1?encode=realjson
的结果:
{
text: "没有谁的生活会一直完美,但无论什么时候,都要看着前方,满怀希望就会所向披靡。",
author: "巫哲",
source: "《撒野》"
}
当您使用的
encode
不为Json
时,API 将以主体文本 ——作者, 来源
的方式组合并返回文本。
网页引用
将下面这段代码放入页面内需要展示一句话的位置即可
<script type="text/javascript" src="https://api.lwl12.com/hitokoto/v1?encode=js&charset=utf-8"></script><span id="lwlhitokoto"><script>lwlhitokoto()</script></span>
请注意,这是一个最简单的调用实例,但我们并不推荐您使用这一方法。使用 Ajax 技术异步请求 JsonP 或 Json 接口会是更好的选择。
由于这类代码需要根据站点实际情况编写,这里不提供代码。您可参考 lwl.moe 或其他网站的调用方式自行完成调用。
一言展示
下方会显示一条随机的一言_(:з」∠)_
刷新试试?会变哦~
谁在使用一言
以下是一言的典型使用案例,欢迎体验。
- EOF -