LWL 的自由天空

一言 API – 链接记忆,走过时光。

我们希望通过一言,链接大家对各方文字的美好记忆,伴你踩碎迷茫,走过时光。

什么是一言

相信大家都有或曾经有过自己的摘抄本。「一言」就好似一个公开的摘抄本,我们在此记录那些让人感怀的,让人振奋的,让人感动的,让人一眼就有所感触的短句,并通过公共 API 的形式使你能够在自己的项目中调用它们。

我们希望通过一言,链接大家对各方文字的美好记忆,伴你踩碎迷茫,走过时光。

如果你不是开发者,只是想在自己的设备上看到「一言」,请移步文末的「谁在使用一言?」部分。

调用方法

获取数据

出于安全考虑,我们仅支持通过 HTTPS 方法调用 API
以下所有参数均仅适用于以 GET 方式请求地址: https://api.lwl12.com/hitokoto/v1

响应数据

当您请求标准 Json 数据时,API 会返回以下内容:

请注意,由于数据收集难度很大,并非所有数据都包含 author / source ,请注意在您的程序中判断这两个值为空的情况。

我们假设现在有一作品 A,其中某一段这样写道:

友人B:看呀,这个一言 API 多么好用!

则当我们收录后,返回的数据就会是这样:

下面是实际请求一次 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 -