docs: 广告位设计 404 码 ALBUM_NOT_PUBLIC 纠正入档 + 实施计划 Task 1-4 勾选

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-28 23:03:32 +08:00
parent 539597e9f0
commit d86f452bed
2 changed files with 20 additions and 19 deletions
@@ -122,7 +122,8 @@ imageStagingKey 必须为本服务签发的 staging 键。
 `GET /v1/public/albums/{token}/ads` → 200 `{ items: [{ adId, imageUrl, linkUrl }] }`

 - token 寻址（公开域惯例，不暴露内部 albumId）；相册不存在/offline → 404
-  ALBUM_NOT_FOUND（与公开相册读同码）。
+  ALBUM_NOT_PUBLIC（与公开相册读同码——实施时核实既有公开端点实码为此，
+  设计原稿写 ALBUM_NOT_PUBLIC 笔误已纠正 2026-09-28）。
 - 过滤：`enabled 投影 ∧ (albumIds 为 null ∨ 含本相册 id)`，按 sortOrder 升序、
  并列 createdAt 升序；imageUrl=presigned GET（TTL=SIGNED_URL_TTL_SECONDS）。
 - 无广告返回空 items（非 404）。不加独立限速档（观众页单次加载调用一次，