API reference

Admin · Review

Review of similar duplicates and cold images awaiting cleanup (admins only)

疑似重复候选

GET
/api/admin/dedup

后台相似扫描(pHash 汉明距离)发现的待裁决候选对,分页。仅管理员。

Authorization

session
cookieimgyoung_session<token>

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

Query Parameters

page?integer

页码,从 1 起;缺省 1

Range1 <= value
page_size?integer

每页条数;缺省 20,上限 100

Range1 <= value <= 100

Response Body

候选分页

application/json
  1. response
items*array<>
total*integer
Formatint64
curl -X GET 'http://localhost:8721/api/admin/dedup'
{  "items": [    {      "id": 0,      "distance": 0,      "created_at": "string",      "a": {        "blob_id": 0,        "image_id": "string",        "mime": "string",        "size": 0,        "width": 0,        "height": 0,        "refs": 0      },      "b": {        "blob_id": 0,        "image_id": "string",        "mime": "string",        "size": 0,        "width": 0,        "height": 0,        "refs": 0      }    }  ],  "total": 0}

合并候选

POST
/api/admin/dedup/{id}/merge

保留指定的一方,另一方的引用并入;保留方必须是候选对中的一方。仅管理员。

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

Request Body

application/json
  1. body
keep_blob_id*integer

保留的物理图 id,须是候选对中的一方

Formatint64

Response Body

已合并

curl -X POST 'http://localhost:8721/api/admin/dedup/0/merge' \  -H 'X-CSRF-Token: string' \  -H 'Content-Type: application/json' \  -d '{  "keep_blob_id": 0}'
Empty

忽略候选

POST
/api/admin/dedup/{id}/dismiss

该候选对不再提示。仅管理员。

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 POST 'http://localhost:8721/api/admin/dedup/0/dismiss' \  -H 'X-CSRF-Token: string'
Empty

冷图待清理列表

GET
/api/admin/cleanup

超过冷图阈值未被公开访问的引用,分页。裁决走图片接口:保留为 PATCH /api/admin/images/{id} 置清理豁免,删除为 DELETE /api/admin/images/{id}。仅管理员。

Authorization

session
cookieimgyoung_session<token>

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

Query Parameters

page?integer

页码,从 1 起;缺省 1

Range1 <= value
page_size?integer

每页条数;缺省 20,上限 100

Range1 <= value <= 100

Response Body

待清理分页

application/json
  1. response
items*array<>
total*integer
Formatint64
curl -X GET 'http://localhost:8721/api/admin/cleanup'
{  "items": [    {      "id": "string",      "url": "string",      "user_id": "string",      "file_name": "string",      "mime": "string",      "size": 0,      "width": 0,      "height": 0,      "last_access_at": "string",      "created_at": "string"    }  ],  "total": 0}