宅社AcgClub API上線

背景

魯迅曰：「不愛折騰的ACGer不是一名好的攻城獅」

因此在完成了開源APP《宅社AcgClub》後，爲了能進一步豐富場景功能，怒點技能樹，本身實現了後端服務。

效果體驗

瀏覽器

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	路徑參數，經過該參數獲取指定類型的壁紙；目前支持的類別：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	該主題下全部的壁紙地址

接口示例

地址：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…