fix(contracts): 广告位 404 码对齐 NOT_FOUND/title 必填/空 PATCH 语义/上限漂移守护

Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
浅念
2026-09-28 22:29:45 +08:00
parent ec55d5718b
commit 001d3aaf73
3 changed files with 61 additions and 11 deletions
+7 -5
View File
@@ -2094,8 +2094,8 @@ paths:
$ref: '#/components/schemas/AdminAdItem'
'400':
description: |
参数校验失败(VALIDATION_FAILED):字段非法、换图三字段未同时提供
或 staging 核验失败(UPLOAD_VERIFY_FAILED)。
参数校验失败(VALIDATION_FAILED):字段非法、空请求体、换图三字段
未同时提供或 staging 核验失败(UPLOAD_VERIFY_FAILED)。
content:
application/json:
schema:
@@ -2109,7 +2109,7 @@ paths:
schema:
$ref: '#/components/schemas/Error'
'404':
description: 广告位不存在(AD_NOT_FOUND)。
description: 广告位不存在(NOT_FOUND)。
content:
application/json:
schema:
@@ -2137,7 +2137,7 @@ paths:
schema:
$ref: '#/components/schemas/Error'
'404':
description: 广告位不存在(AD_NOT_FOUND)。
description: 广告位不存在(NOT_FOUND)。
content:
application/json:
schema:
@@ -4774,6 +4774,7 @@ components:
过期后重拉列表刷新。
required:
- id
- title
- imageObjectKey
- imageUrl
- linkUrl
@@ -4875,7 +4876,8 @@ components:
AdUpdateRequest:
type: object
description: |
部分更新请求(仅提交的字段被修改)。albumIds:未提供=不动,null=转
部分更新请求(仅提交的字段被修改,空请求体 400 VALIDATION_FAILED,
对照 EmbedSlotUpdateRequest 口径)。albumIds:未提供=不动,null=转
全局,数组=整体替换;imageStagingKey/imageBytes/imageContentType 三者
必须同时提供(换图,服务端核验 staging 后转存新版本键)。
properties: