API 参考读取 API

指定月排行

同一套逻辑,周期换成月。

GET/api/v1/rankings/monthly
GET
/api/v1/rankings/monthly

与周榜同一套逻辑,周期换成月。参数与缺省规则见 /api/v1/rankings/weekly。

Authorization

bearerAuth
AuthorizationBearer <token>

Authorization: Bearer <key>。key 由控制台自助签发,或管理员在 /dashboard 代签

In: header

Query Parameters

year?integer

四位年份。缺省为最近一个完整周期

month?integer

月份 1–12

Range1 <= value <= 12
limit?integer

返回条数上限,缺省 100

Range1 <= value

Response 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"      }    }  ]}