GET `/files/{id}/metadata`

获取文件的详细元数据信息，包括MinIO对象存储中的实际信息（最后修改时间、ETag校验值、大小等），用于校验数据库与存储一致性。参考：GDPR Art 32 (Security of Processing)。

存储服务 `bearerAuth` application/json

Request Parameters

Name	In	Type	Required	Default	Example	Constraints	Description
`id`	`path`	`string`	Yes				文件ID

Responses

Status	Description	Schema
200	文件元数据（含MinIO对象存储信息）	`dto.FileMetadataExtendedDetailResponse`
401	未认证或令牌已过期	`dto.Problem`
404	文件不存在或为文件夹	`dto.Problem`
500	服务器内部错误	`dto.Problem`

Referenced Schemas

dto.FieldViolation

Field	Type	Required	Example	Constraints	Description
`code`	`string`	No			Code 是错误代码（可选）用于程序识别错误类型，如 "required", "format", "range"
`description`	`string`	No			Description 是人类可读的错误描述应该说明违反了什么规则，如 "必须是一个有效的邮箱地址"
`field`	`string`	No			Field 是错误字段的路径使用点号表示嵌套字段，如 "user.email" 或 "addresses[0].city"
`value`	`object`	No			Value 是导致错误的值（可选，开发模式下使用）生产环境可能不返回此字段以避免泄露敏感信息

dto.FileMetadataExtendedDetailResponse

Field	Type	Required	Example	Constraints	Description
`code`	`integer`	No
`data`	`dto.FileMetadataExtendedResponse`	No
`message`	`string`	No
`timestamp`	`string`	No

dto.FileMetadataExtendedResponse

文件详细元数据信息，包含MinIO存储信息

Field	Type	Required	Example	Constraints	Description
`access_url`	`string`	No	`https://cdn.example.com/file_abc123.jpg`
`bucket`	`string`	No	`avatars`
`checksum`	`string`	No	`abc123`
`content_type`	`string`	No	`image/jpeg`
`created_at`	`string`	No	`2026-04-15T10:00:00Z`
`filename`	`string`	No	`avatar.jpg`
`id`	`string`	No	`file_abc123`
`is_public`	`boolean`	No	`False`
`key`	`string`	No	`2026/04/file_abc123.jpg`
`metadata`	`string`	No
`minio_info`	`dto.MinioInfoResponse`	No
`modified_at`	`string`	No	`2026-04-15T10:30:00Z`
`original_name`	`string`	No	`avatar.jpg`
`owner_id`	`string`	No	`usr_abc123`
`path`	`string`	No	`2026/04/file_abc123.jpg`
`provider`	`string`	No	`minio`
`size`	`integer`	No	`102400`
`tenant_id`	`string`	No	`tnt_xyz789`

dto.MinioInfoResponse

MinIO存储对象统计信息

Field	Type	Required	Example	Constraints	Description
`content_type`	`string`	No	`image/jpeg`
`etag`	`string`	No	`"abc123"`
`last_modified`	`string`	No	`2026-04-15T10:30:00Z`
`size`	`integer`	No	`102400`

dto.Problem

Field	Type	Required	Example	Constraints	Description
`code`	`integer`	No			Code 是业务错误码用于程序处理特定错误场景示例：30101001
`detail`	`string`	No			Detail 是针对此具体错误实例的人类可读解释可以包含具体的错误细节，如"Field 'email' is required"
`errors`	array of See `dto.FieldViolation`	No			Errors 是字段级验证错误列表（扩展字段）遵循 Web API 标准实践，每个错误包含字段名和错误信息
`i18n_args`	`object`	No			I18nArgs 是国际化参数用于动态填充翻译模板
`i18n_key`	`string`	No			I18nKey 是国际化键用于客户端本地化错误消息示例："error.user_not_found"
`instance`	`string`	No			Instance 是发生问题的具体URI引用通常是请求的URL，可能包含查询参数示例："/api/v1/users?limit=invalid"
`request_id`	`string`	No			RequestID 是请求唯一标识用于日志关联和问题追踪示例："req_550e8400-e29b-41d4-a716-446655440000"
`retry_after`	`integer`	No			RetryAfter 用于 429 Too Many Requests 响应指示客户端应在多少秒后重试请求（RFC 6585）
`service`	`string`	No			Service 是服务名用于微服务架构中定位错误来源示例："auth-service"
`span_id`	`string`	No			SpanID 是当前 span 标识用于精确定位分布式链路中的当前节点
`status`	`integer`	No			Status 是产生的HTTP状态码用于客户端区分问题类型，不随Accept-Language变化示例：400, 401, 403, 404, 500
`timestamp`	`string`	No			Timestamp 是错误发生时间 ISO 8601 格式示例："2026-04-03T12:00:00Z"
`title`	`string`	No			Title 是简短、人类可读的问题类型摘要相同的 Type 应该始终有相同的 Title（不随实例变化）示例："Invalid Request Parameters"
`trace_id`	`string`	No			TraceID 是分布式追踪标识遵循 W3C Trace Context 标准示例："00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"
`type`	`string`	No			Type 是标识问题类型的URI引用当该URI被解引用时，应提供人类可读的文档示例："https://api.example.com/errors/invalid-request"

Try this API in Scalar → Download OpenAPI spec (JSON) ↓

↑