POST `/communication/sms`

向指定手机号码发送短信。支持模板发送（需预定义模板）或直接发送内容，自动记录到发送日志。参考：ePrivacy Directive 2002/58/EC、CAN-SPAM Act。

通信服务 `bearerAuth` application/json

请求体

Schema： service-communication/internal/handler/dto.SMSRequest

字段	类型	必填	示例	约束	描述
`phone`	`string`	是	`13800138000`		手机号
`content`	`string`	否	`您的验证码是123456`		内容
`purpose`	`string`	否	`sms_verification`		Purpose 业务场景（审计/路由/脱敏；可选，向后兼容）。
`send_at`	`string`	否	`2026-06-07T10:00:00Z`
`template`	`string`	否	`verify_code`		模板
`user_id`	`string`	否	`usr_abc123`		用户ID
`variables`	`object`	否		extra keys: `string`	变量

响应

状态	描述	Schema
200	发送成功，返回发送日志详情	`service-communication/internal/handler/dto.CommunicationLogDetailResponse`
400	请求参数错误	`dto.SimpleResponse`
401	未认证或令牌无效	`dto.SimpleResponse`
403	无权访问该资源	`dto.SimpleResponse`
404	资源不存在	`dto.SimpleResponse`
500	服务内部错误	`dto.SimpleResponse`

引用的 Schema

dto.SimpleResponse

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

service-communication/internal/handler/dto.CommunicationLogDetailResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`data`	`service-communication/internal/handler/dto.CommunicationLogResponse`	否
`message`	`string`	否
`timestamp`	`string`	否

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）↓