GET /communication/health/{channel}

检查指定通信渠道(sms/email/push)的服务商配置和连通性状态。用于运维监控,验证服务商API端点是否可达、配置是否有效。公开端点,无需认证。参考:ePrivacy Directive 2002/58/EC、CAN-SPAM Act。

通信服务 None application/json

请求参数

名称位置类型必填默认值示例约束描述
channel path string 是 通信渠道:sms/email/push

响应

状态描述Schema
200检查成功,返回渠道健康状态(healthy/unhealthy/not_configured)service-communication/internal/handler/dto.ChannelHealthDataResponse
400渠道参数无效dto.SimpleResponse
500健康检查内部错误dto.SimpleResponse

引用的 Schema

dto.SimpleResponse

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

service-communication/internal/handler/dto.ChannelHealthDataResponse

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

service-communication/internal/handler/dto.ChannelHealthResponse

渠道连通性检查结果

字段类型必填示例约束描述
channel string 否 sms
message string 否 SMS provider is reachable
provider string 否 aliyun
status string 否 healthy