POST `/communication/callback/{provider}`

接收并处理各短信、邮件、推送服务商（阿里云、腾讯云、AWS SNS/SES、SendGrid、Mailgun、FCM、APNs、JPush等）的投递状态回调通知，自动更新对应消息的发送状态。回调为公开端点，必须携带 HMAC-SHA256 签名（X-Callback-Signature，hex；密钥见 callback.secret），签名缺失/不符一律 401。参考：ePrivacy Directive 2002/58/EC、CAN-SPAM Act。

通信服务 None application/json

请求参数

名称	位置	类型	必填	默认值	示例	约束	描述
`provider`	`path`	`string`	是				服务商名称：aliyun/tencentcloud/aws/sendgrid/ses/mailgun/fcm/apns/jpush
`X-Callback-Signature`	`header`	`string`	是				回调体 HMAC-SHA256 签名（hex，密钥 = callback.secret）

请求体

接受空 JSON 对象 {}

响应

状态	描述	Schema
200	回调已接收确认	`service-communication/internal/handler/dto.CallbackResultDetailResponse`
400	请求数据格式错误	`dto.SimpleResponse`
401	回调签名缺失或无效	`dto.SimpleResponse`
404	回调指向的消息不存在	`dto.SimpleResponse`
500	回调处理内部错误/验签密钥未配置	`dto.SimpleResponse`

引用的 Schema

dto.SimpleResponse

字段	类型	必填
`code`	`integer`	否
`message`	`string`	否
`timestamp`	`string`	否

service-communication/internal/handler/dto.CallbackResultDetailResponse

字段	类型	必填
`code`	`integer`	否
`data`	`service-communication/internal/handler/dto.CallbackResultResponse`	否
`message`	`string`	否
`timestamp`	`string`	否

service-communication/internal/handler/dto.CallbackResultResponse

提供商回调结果

字段	类型	必填	示例	约束	描述
`provider`	`string`	否	`aliyun`
`received`	`boolean`	否	`True`

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

POST /communication/callback/{provider}