背景
鲁迅曰：“不爱折腾的ACGer不是一名好的攻城狮”
所以在完成了开源APP《宅社AcgClub》后，为了能进一步丰富场景功能，怒点技能树，自己实现了后端服务。
效果体验
小程序
接口
1. 获取次元壁纸列表
URL
-
获取所有类别的壁纸
https://rabtman.com/api/v2/acgclub/pictures -
获取指定类别的壁纸
https://rabtman.com/api/v2/acgclub/category/{type}/pictures
支持格式
JSON
HTTP请求方式
GET
请求参数
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| {type} | false | string | 路径参数，通过该参数获取指定类型的壁纸；目前支持的类别：moeimg、cosplay、gamersky |
| offset | false | int | 请求的页码，默认值为：1 |
| limit | false | int | 每一页返回的结果数，默认值为：20，取值范围：20~60 |
| query | false | string | 搜索关键字 |
返回字段
| 返回字段 | 字段类型 | 说明 |
|---|---|---|
| title | string | 壁纸名称 |
| type | string | 壁纸所属类别 |
| thumbnail | string | 壁纸展示缩略图 |
| sort | string or int | 壁纸顺序id |
| imgUrls | array | 该主题下所有的壁纸地址 |
接口示例
{
"message": "请求成功",
"data": [{
"thumbnail": "http://imgs.gamersky.com/upimg/2018/201802031433291315.jpg",
"title": "《Fate/Stay night》官方公布远坂凛生日壁纸",
"type": "gamersky",
"sort": 1010964,
"imgUrls": [
"http://img1.gamersky.com/image2018/02/20180203_ljt_220_5/gamersky_01origin_01_201823142764B.jpg",
"http://img1.gamersky.com/image2018/02/20180203_ljt_220_5/gamersky_02origin_03_2018231427A25.jpg"
]
}]
}
其他说明
壁纸每天更新一次，大概在凌晨5点完成更新，建议进行适当的缓存。
附录
返回的基础字段
| 返回字段 | 字段类型 | 说明 |
|---|---|---|
| message | string | 请求响应的信息 |
| data | object or array | 响应的结果信息，可能为一个对象或数组 |
请求限制
为减轻服务器压力，对请求的频率进行了限制。
目前api请求限制为：30/分钟、3/秒
状态码
| 状态码 | 描述 |
|---|---|
| 200 | 请求成功 |
| 400 | 参数异常 |
| 404 | 找不到该页面 |
| 500 | 服务器异常 |
最后
欢迎大家使用，如有建议与问题，可在issue上提出，后续将在github wiki上进行更新，地址：github.com/Rabtman/Acg…
