POST `/push/subscriptions`

注册 Web Push 订阅（RFC 8030 VAPID），用于接收推送通知参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。

通知服务 `bearerAuth` application/json

请求体

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

字段	类型	必填	示例	约束	描述
`endpoint`	`string`	是	`https://fcm.googleapis.com/fcm/send/...`
`keys`	`service-notification/internal/handler/dto.PushSubscriptionKeys`	是
`device_name`	`string`	否	`Chrome on Windows`
`device_type`	`string`	否	`web`
`user_agent`	`string`	否

响应

状态	描述	Schema
201	注册成功	`service-notification/internal/handler/dto.PushSubscriptionDetailResponse`
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.PushSubscriptionDetailResponse

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

service-notification/internal/handler/dto.PushSubscriptionKeys

字段	类型	必填	示例	约束	描述
`auth`	`string`	是	`xK2s9...`
`p256dh`	`string`	是	`BP7S2s9...`

service-notification/internal/handler/dto.PushSubscriptionResponse

字段	类型	必填	示例	约束	描述
`created_at`	`string`	否	`2026-05-12T12:00:00Z`
`device_name`	`string`	否	`Chrome on Windows`
`device_type`	`string`	否	`web`
`endpoint`	`string`	否	`https://fcm.googleapis.com/fcm/send/...`
`id`	`string`	否	`sub-abc123`

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