宅社AcgClub API上線

rabtman發表於2019-02-26
GCAPI

背景

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

宅社AcgClub API上線

所以在完成了開源APP《宅社AcgClub》後，為了能進一步豐富場景功能，怒點技能樹，自己實現了後端服務。

效果體驗

瀏覽器

Android App

Android App

小程式

宅社AcgClub API上線

介面

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…

相關文章