API reference

Admin · Hotlink protection

Referer allowlist (admins only)

防盗链规则

GET
/api/admin/referer-whitelist

白名单为空即不启用防盗链。仅管理员。

Authorization

session
cookieimgyoung_session<token>

登录下发的会话 cookie;状态变更请求须另以 X-CSRF-Token 头回传会话绑定的 CSRF 令牌。

Response Body

规则列表

application/json
  1. response
items*array<>
total*integer
Formatint64
curl -X GET 'http://localhost:8721/api/admin/referer-whitelist'
{  "items": [    {      "id": 0,      "pattern": "string",      "created_at": "string"    }  ],  "total": 0}

添加规则

POST
/api/admin/referer-whitelist

裸域(example.com,精确匹配)或子域通配(*.example.com,只匹配子域);添加即时生效。仅管理员。

Authorization

session
cookieimgyoung_session<token>

登录下发的会话 cookie;状态变更请求须另以 X-CSRF-Token 头回传会话绑定的 CSRF 令牌。

Header Parameters

X-CSRF-Token*string

登录或 GET /api/admin/me 响应里的 csrf_token;缺失或不匹配返回 403

Request Body

application/json
  1. body
pattern*string

裸域(example.com)或子域通配(*.example.com)

Response Body

已添加

application/json
  1. response
id*integer
Formatint64
pattern*string

裸域或子域通配

created_at*string
curl -X POST 'http://localhost:8721/api/admin/referer-whitelist' \  -H 'X-CSRF-Token: string' \  -H 'Content-Type: application/json' \  -d '{  "pattern": "string"}'
{  "id": 0,  "pattern": "string",  "created_at": "string"}

删除规则

DELETE
/api/admin/referer-whitelist/{id}

删除即时生效。仅管理员。

Authorization

session
cookieimgyoung_session<token>

登录下发的会话 cookie;状态变更请求须另以 X-CSRF-Token 头回传会话绑定的 CSRF 令牌。

Path Parameters

id*integer

规则行 id

Formatint64

Header Parameters

X-CSRF-Token*string

登录或 GET /api/admin/me 响应里的 csrf_token;缺失或不匹配返回 403

Response Body

已删除

curl -X DELETE 'http://localhost:8721/api/admin/referer-whitelist/0' \  -H 'X-CSRF-Token: string'
Empty