本站API接口已于2023.06.01正式关闭使用，目前正在改版接口规则，重新开放日期请关注博客公告！
针对已发布的 一言 和 背景图 两个接口，因为接口可以随机挑选分类所以没有给大家开放获取分类的接口，经过考虑还是充分尊重开发者的使用意愿现开放这两个接口的API。
获取分类信息
接口最后更新时间：2023.02.28
文档最后更新时间：2023.03.22
接口介绍
获取一言 或 背景图 的分类信息
使用场景
当您需要自行决定两个接口分类时。
使用限制
- key
- 目前调用量没有限制
- Qps过高会被服务器拒绝
提示
该接口24小时更新一次缓存，后台更新分类时会立即更新缓存。建议站长同步缓存数据以减少被服务器拒绝的概率。
接口
获取分类信息的接口地址
| 接口名称 | URL | 请求方式 |
|---|---|---|
| 背景图分类 | https://api.cptyun.com/api/v1/getBackimagesType?parameters | GET |
| 一言分类 | https://api.cptyun.com/api/v1/getOneWordType?parameters | GET |
请求参数
| 参数名 | 含义 | 必须 | 缺省值 |
|---|---|---|---|
| key | 请求服务权限标识 | 是 | 无 |
| sig | 与服务器校验加密值 | 是 | 无 |
| output | 返回值 | 否 | JSON |
返回参数
返回结果参数说明
| 名称 | 含义 | 说明 |
|---|---|---|
| status | 状态码 | 200为正常，204为Key无效或过期，205为Sig计算错误，500服务器错误 |
| success | 请求状态 | 仅有500情况下会返回false，标明是服务器出现错误，与调用方无关；其余情况下均返回true（无论是否正常返回结果） |
| msg | success描述 | 参考success |
| data | 返回的数据 | 主要返回的数据位于该字段 |
| data-type | 分类值 | 该字段内容同样为JSON值，正常取值即可 |
服务示例
略
评论区