xinyouhe/photo-live
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(contracts): locale fallback wording on public endpoints

Browse Source 
Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
浅念
2026-09-17 18:11:21 +08:00
parent f6448bd006
commit b4ee92de96
2 changed files with 8 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files
packages/contracts/openapi.yaml
+3 -3
View File
@@ -783,7 +783,7 @@ paths:
schema: schema:
$ref: '#/components/schemas/PublicAlbum' $ref: '#/components/schemas/PublicAlbum'
'400': '400':
description: 查询参数校验失败（VALIDATION_FAILED）。 description: 查询参数校验失败（VALIDATION_FAILED；locale 取值不支持时不报错，按 defaultLocale 回退）。
content: content:
application/json: application/json:
schema: schema:
@@ -832,7 +832,7 @@ paths:
schema: schema:
$ref: '#/components/schemas/PublicPhotoList' $ref: '#/components/schemas/PublicPhotoList'
'400': '400':
description: 查询参数校验失败（VALIDATION_FAILED）。 description: 查询参数校验失败（category/cursor/limit；locale 取值不支持时不报错，按 defaultLocale 回退）。
content: content:
application/json: application/json:
schema: schema:
@@ -935,7 +935,7 @@ components:
LocaleQuery: LocaleQuery:
name: locale name: locale
in: query in: query
description: 请求语言；缺省时按相册 defaultLocale 回退。 description: 请求语言；缺省或取值不支持时按相册 defaultLocale 回退（不报 400，响应 resolvedLocale 指示实际返回语言）。
schema: schema:
$ref: '#/components/schemas/Locale' $ref: '#/components/schemas/Locale'
packages/contracts/src/generated/openapi.d.ts
Vendored
+5 -5
View File
@@ -908,7 +908,7 @@ export interface components {
AlbumPublicToken: string; AlbumPublicToken: string;
/** @description 分页游标（上一页响应的 nextCursor）。 */ /** @description 分页游标（上一页响应的 nextCursor）。 */
CursorQuery: string; CursorQuery: string;
/** @description 请求语言；缺省时按相册 defaultLocale 回退。 */ /** @description 请求语言；缺省或取值不支持时按相册 defaultLocale 回退（不报 400，响应 resolvedLocale 指示实际返回语言）。 */
LocaleQuery: components["schemas"]["Locale"]; LocaleQuery: components["schemas"]["Locale"];
}; };
requestBodies: never; requestBodies: never;
@@ -1783,7 +1783,7 @@ export interface operations {
getPublicAlbum: { getPublicAlbum: {
parameters: { parameters: {
query?: { query?: {
/** @description 请求语言；缺省时按相册 defaultLocale 回退。 */ /** @description 请求语言；缺省或取值不支持时按相册 defaultLocale 回退（不报 400，响应 resolvedLocale 指示实际返回语言）。 */
locale?: components["parameters"]["LocaleQuery"]; locale?: components["parameters"]["LocaleQuery"];
}; };
header?: never; header?: never;
@@ -1804,7 +1804,7 @@ export interface operations {
"application/json": components["schemas"]["PublicAlbum"]; "application/json": components["schemas"]["PublicAlbum"];
}; };
}; };
/** @description 查询参数校验失败（VALIDATION_FAILED）。 */ /** @description 查询参数校验失败（VALIDATION_FAILED；locale 取值不支持时不报错，按 defaultLocale 回退）。 */
400: { 400: {
headers: { headers: {
[name: string]: unknown; [name: string]: unknown;
@@ -1830,7 +1830,7 @@ export interface operations {
query?: { query?: {
/** @description 分类 ID 过滤（来自 PublicAlbum.categories 的 id）。 */ /** @description 分类 ID 过滤（来自 PublicAlbum.categories 的 id）。 */
category?: string; category?: string;
/** @description 请求语言；缺省时按相册 defaultLocale 回退。 */ /** @description 请求语言；缺省或取值不支持时按相册 defaultLocale 回退（不报 400，响应 resolvedLocale 指示实际返回语言）。 */
locale?: components["parameters"]["LocaleQuery"]; locale?: components["parameters"]["LocaleQuery"];
/** @description 分页游标（上一页响应的 nextCursor）。 */ /** @description 分页游标（上一页响应的 nextCursor）。 */
cursor?: components["parameters"]["CursorQuery"]; cursor?: components["parameters"]["CursorQuery"];
@@ -1855,7 +1855,7 @@ export interface operations {
"application/json": components["schemas"]["PublicPhotoList"]; "application/json": components["schemas"]["PublicPhotoList"];
}; };
}; };
/** @description 查询参数校验失败（VALIDATION_FAILED）。 */ /** @description 查询参数校验失败（category/cursor/limit；locale 取值不支持时不报错，按 defaultLocale 回退）。 */
400: { 400: {
headers: { headers: {
[name: string]: unknown; [name: string]: unknown;