阅读 4535

宅社AcgClub API上线

背景

鲁迅曰:“不爱折腾的ACGer不是一名好的攻城狮”

所以在完成了开源APP《宅社AcgClub》后,为了能进一步丰富场景功能,怒点技能树,自己实现了后端服务。

效果体验

浏览器

Android App

Android App

小程序

接口

1. 获取次元壁纸列表

URL

  • 获取所有类别的壁纸

    https://rabtman.com/api/v2/acgclub/pictures

  • 获取指定类别的壁纸

    https://rabtman.com/api/v2/acgclub/category/{type}/pictures

支持格式

JSON

HTTP请求方式

GET

请求参数

参数 必选 类型 说明
{type} false string 路径参数,通过该参数获取指定类型的壁纸;目前支持的类别:moeimgcosplaygamersky
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 该主题下所有的壁纸地址

接口示例

地址:rabtman.com/api/v2/acgc…

{
	"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…

关注下面的标签,发现更多相似文章
评论

查看更多 >