DELETE `/notifications/{notification_id}`

删除指定ID的通知记录（软验证用户ID匹配）参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。

通知服务 `bearerAuth` application/json

请求参数

名称	位置	类型	必填	默认值	示例	约束	描述
`notification_id`	`path`	`string`	是				通知ID

请求体

Schema： service-notification/internal/handler/dto.DeleteNotificationRequest

字段	类型	必填	示例	约束	描述
`notification_id`	`string`	是	`ntf_abc123`		通知ID
`user_id`	`string`	是	`usr_abc123`		用户ID

响应

状态	描述	Schema
200	删除成功	`service-notification/internal/handler/dto.DeleteNotificationDetailResponse`
400	请求参数错误	`service-core/base/dto.SimpleResponse`
401	未认证	`service-core/base/dto.SimpleResponse`
403	权限不足	`service-core/base/dto.SimpleResponse`
404	资源未找到	`service-core/base/dto.SimpleResponse`
500	服务内部错误	`service-core/base/dto.SimpleResponse`

引用的 Schema

service-core/base/dto.SimpleResponse

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

service-notification/internal/handler/dto.DeleteNotificationDetailResponse

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

service-notification/internal/handler/dto.DeleteNotificationResponse

删除通知结果

字段	类型	必填	示例	约束	描述
`deleted`	`boolean`	否	`True`		删除成功
`notification_id`	`string`	否	`ntf_abc123`		通知ID

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