概念云开放API - 一言-南小濡的技术窝

本站API接口已于2023.06.01正式关闭使用，目前正在改版接口规则，重新开放日期请关注博客公告！

欢迎使用概念云开放API - 一言接口！
本站一言接口数据库数据来源：Hitokoto·一言

一言

接口最后更新时间 2023.02.20
文档最后更新时间 2023.03.02

接口介绍

一言是一个提供一句话的HTTP接口，根据用户输入的type或随机选择一个已有type返回一句话。
使用API前需要您先申请Key，Key申请请看：概念云开放API - 签名密钥获取及生成方法

使用场景

需要展示即可使用。

使用限制

key
调用量目前并无限制
Qps过高会被服务器暂时拒绝服务

使用说明

第一步申请Key
第二步拼接HTTP请求URL，第一步申请的key需要连带sig作为参数一起发送
第三步接收返回的数据（JSON），解析数据
如无特殊声明，接口的输入参数和输出数据编码全部统一为UTF-8。

一言接口

一言接口服务地址

URL	https://api.cptyun.com/api/v1/getOneword?parameters
请求方式	GET

parameters 代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。

请求参数

参数名	含义	是否必须	缺省值
key	请求服务权限标识	是	无
sig	与服务器校验身份加密值	是	无
type	一言类型，目前为`a - l（L）`，不传会随机一个	否	a-l
output	返回格式	否	JSON

返回结果参数说明

名称	含义	规则说明
status	状态码	200为正常，204为Key无效或过期，205为Sig计算错误，500服务器错误
success	请求状态	仅有500情况下会返回false，标明是服务器出现错误，与调用方无关；其余情况下均返回true（无论是否正常返回结果）
msg	success描述	参考`success`
data	返回的数据	主要返回数据位于该字段
oid	ID值	仅识别
type	归属类型	仅归类
content	一言	内容
from	作者	仅供参考
length	一言长度	标点符号也占位，`from`不计算在内

服务示例
请求地址（不传type）： https://api.cptyun.com/api/v1/getOneword?key=123456&sig=123456

{
  "static": 200,
  "success": true,
  "msg": "OK",
  "data": {
    "oid": 6468,
    "type": "l",
    "content": "一朝耍流氓，十年挂南墙；不乖的孩子统统都要打屁股；越狱是不可能越狱的，这辈子是不可能越狱的。",
    "from": "bilibili小黑屋",
    "length": 46
  }
}

请求地址（传type）： https://api.cptyun.com/api/v1/getOneword?type=a&key=123456&sig=123456

{
  "static": 200,
  "success": true,
  "msg": "OK",
  "data": {
    "oid": 69,
    "type": "a",
    "content": "喜欢上你，爱上你，真是太好了，谢谢。",
    "from": "龙虎斗",
    "length": 18
  }
}

目录CONTENT

概念云开放API - 一言