GET `/admin/communication/logs`

管理员可按用户ID查询任意用户的通信日志，支持分页和渠道、状态筛选。与普通用户GetLogs接口不同，此接口不受用户隔离限制。参考：ePrivacy Directive 2002/58/EC、CAN-SPAM Act。

通信服务 `bearerAuth` application/json

请求参数

名称	位置	类型	必填	默认值	示例	约束	描述
`user_id`	`query`	`string`	否				目标用户ID（不传返回全部用户的日志）
`channel`	`query`	`string`	否				发送渠道筛选：sms/email/push
`status`	`query`	`string`	否				发送状态筛选：pending/sent/failed/delivered
`page`	`query`	`integer`	否				页码，从1开始（默认1）
`page_size`	`query`	`integer`	否				每页条数（默认20）

响应

状态	描述	Schema
200	查询成功，返回完整通信日志列表	`service-communication/internal/handler/dto.CommunicationLogListResponse`
400	请求参数错误	`dto.SimpleResponse`
401	未认证或令牌无效	`dto.SimpleResponse`
403	无权访问该资源（仅管理员）	`dto.SimpleResponse`
500	服务内部错误	`dto.SimpleResponse`

引用的 Schema

dto.PageInfo

字段	类型	必填	示例	约束	描述
`has_next`	`boolean`	否			HasNext indicates whether there is a next page
`has_prev`	`boolean`	否			HasPrev indicates whether there is a previous page
`page`	`integer`	否			Page is the current page number (1-based)
`page_size`	`integer`	否			PageSize is the number of items per page
`total`	`integer`	否			Total is the total number of items across all pages
`total_pages`	`integer`	否			TotalPages is the total number of pages

dto.SimpleResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`message`	`string`	否
`timestamp`	`string`	否

service-communication/internal/handler/dto.CommunicationLogListResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`items`	array of 参见 `service-communication/internal/handler/dto.CommunicationLogResponse`	否			统一使用 items
`message`	`string`	否
`pagination`	`object`	否			分页信息（嵌套对象）
`timestamp`	`string`	否
`total`	`integer`	否			总条数（平铺，便于直接读取）

service-communication/internal/handler/dto.CommunicationLogResponse

消息发送日志记录

字段	类型	必填	示例	约束	描述
`channel`	`string`	否	`sms`
`content`	`string`	否	`您的验证码是123456`
`created_at`	`string`	否	`2026-04-15T10:00:00Z`
`error`	`string`	否	`发送超时`
`id`	`string`	否	`log_abc123`
`provider`	`string`	否	`aliyun`
`recipient`	`string`	否	`138****8000`
`response`	`string`	否
`sent_at`	`string`	否	`2026-04-15T10:01:00Z`
`status`	`string`	否	`delivered`
`template_id`	`string`	否	`tpl_abc123`
`tenant_id`	`string`	否	`tnt_xyz789`
`updated_at`	`string`	否	`2026-04-15T10:00:00Z`
`user_id`	`string`	否	`usr_abc123`

在 Scalar 中试用此 API → 下载 OpenAPI 规范（JSON）↓