API 参考读取 API
指定月排行
同一套逻辑,周期换成月。
GET
/api/v1/rankings/monthlyGET
与周榜同一套逻辑,周期换成月。参数与缺省规则见 /api/v1/rankings/weekly。
Authorization
bearerAuth AuthorizationBearer <token>
Authorization: Bearer <key>。key 由控制台自助签发,或管理员在 /dashboard 代签
In: header
Query Parameters
year?integer
四位年份。缺省为最近一个完整周期
month?integer
月份 1–12
Range
1 <= value <= 12limit?integer
返回条数上限,缺省 100
Range
1 <= valueResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/rankings/monthly"{ "period": "week", "year": 0, "week": 0, "month": 0, "trending": [ { "name": "string", "fullName": "string", "description": "string", "stars": 0, "delta": 0, "relativeGrowth": 0, "tags": [ "string" ], "ownerId": 0, "createdAt": "2019-08-24T14:15:22Z", "logo": "string", "iconUrl": "string", "avatar": "string", "anomaly": { "kind": "star_cliff", "severity": "down", "title": "string" } } ], "byRelativeGrowth": [ { "name": "string", "fullName": "string", "description": "string", "stars": 0, "delta": 0, "relativeGrowth": 0, "tags": [ "string" ], "ownerId": 0, "createdAt": "2019-08-24T14:15:22Z", "logo": "string", "iconUrl": "string", "avatar": "string", "anomaly": { "kind": "star_cliff", "severity": "down", "title": "string" } } ]}