docs(contracts): locale fallback wording on public endpoints

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
+5 -5
View File
@@ -908,7 +908,7 @@ export interface components {
AlbumPublicToken: string;
/** @description 分页游标(上一页响应的 nextCursor)。 */
CursorQuery: string;
/** @description 请求语言;缺省时按相册 defaultLocale 回退。 */
/** @description 请求语言;缺省或取值不支持时按相册 defaultLocale 回退(不报 400,响应 resolvedLocale 指示实际返回语言)。 */
LocaleQuery: components["schemas"]["Locale"];
};
requestBodies: never;
@@ -1783,7 +1783,7 @@ export interface operations {
getPublicAlbum: {
parameters: {
query?: {
/** @description 请求语言;缺省时按相册 defaultLocale 回退。 */
/** @description 请求语言;缺省或取值不支持时按相册 defaultLocale 回退(不报 400,响应 resolvedLocale 指示实际返回语言)。 */
locale?: components["parameters"]["LocaleQuery"];
};
header?: never;
@@ -1804,7 +1804,7 @@ export interface operations {
"application/json": components["schemas"]["PublicAlbum"];
};
};
/** @description 查询参数校验失败(VALIDATION_FAILED)。 */
/** @description 查询参数校验失败(VALIDATION_FAILED;locale 取值不支持时不报错,按 defaultLocale 回退)。 */
400: {
headers: {
[name: string]: unknown;
@@ -1830,7 +1830,7 @@ export interface operations {
query?: {
/** @description 分类 ID 过滤(来自 PublicAlbum.categories 的 id)。 */
category?: string;
/** @description 请求语言;缺省时按相册 defaultLocale 回退。 */
/** @description 请求语言;缺省或取值不支持时按相册 defaultLocale 回退(不报 400,响应 resolvedLocale 指示实际返回语言)。 */
locale?: components["parameters"]["LocaleQuery"];
/** @description 分页游标(上一页响应的 nextCursor)。 */
cursor?: components["parameters"]["CursorQuery"];
@@ -1855,7 +1855,7 @@ export interface operations {
"application/json": components["schemas"]["PublicPhotoList"];
};
};
/** @description 查询参数校验失败(VALIDATION_FAILED)。 */
/** @description 查询参数校验失败(category/cursor/limit;locale 取值不支持时不报错,按 defaultLocale 回退)。 */
400: {
headers: {
[name: string]: unknown;