一言 - 文档 | Qianyun API

一言

调用此 API 会返回随机的一言

请求URL

https://api.zhangxiaojie.tk/api/v1/words
参数名称 模式 参数说明 形式
无 [默认] 无
INFO 追加 获取详细信息 大写
id 追加+参数 搜索id 小写
author 追加+参数 搜索author 小写
返回 JSON

响应体

JSON
{
  "code": 200,
  "version": "v1",
  "data": {
    "id": "202",
    "words": "葡萄美酒夜光杯，欲饮琵琶马上催。",
    "author": "a632079",
    "from_source": "凉州词二首·其一",
    "length": 16
  }
}

解释

参数名称 返回值 参数说明 父集合
code 200 请求状态 null
version v1 版本信息 null
data { } 回调内容 null
id 2 一言id data
words 葡萄…… 一言 data
author a632079 作者 data
from_source 凉州词二 获取的平台 data
length 16 一言长度 data
INFO 返回 详细信息
JSON
{
  "code": 200,
  "version": "v1",
  "data": {
    ……
   "info": {
      "website": null,
      "get_time": "2018-08-24 08:50:32"
    }
  }
}
参数名称 返回值 参数说明 父集合
info { } 详细信息 data
website htt…… 来源链接 info
get_time 201…… 获取时间 info

搜索

凡是搜索都用小写

id

  • 搜索id
    • https://api.zhangxiaojie.tk/api/v1/words?id=1

    author

  • 搜索author
    • https://api.zhangxiaojie.tk/api/v1/words?author=test

    叠加搜索

    https://api.zhangxiaojie.tk/api/v1/words?id=1&author=test