POST /push/subscriptions
注册 Web Push 订阅（RFC 8030 VAPID），用于接收推送通知 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。
通知服务 `bearerAuth` application/json
Request Body
Schema: dto.PushSubscriptionRequest
| Field | Type | Required | Example | Constraints | Description |
|---|
endpoint |
string |
Yes |
https://fcm.googleapis.com/fcm/send/... |
|
|
keys |
dto.PushSubscriptionKeys |
Yes |
|
|
|
device_name |
string |
No |
Chrome on Windows |
|
|
device_type |
string |
No |
web |
|
|
user_agent |
string |
No |
|
|
|
Referenced Schemas
dto.PushSubscriptionDetailResponse
dto.PushSubscriptionKeys
| Field | Type | Required | Example | Constraints | Description |
|---|
auth |
string |
Yes |
xK2s9... |
|
|
p256dh |
string |
Yes |
BP7S2s9... |
|
|
dto.PushSubscriptionResponse
| Field | Type | Required | Example | Constraints | Description |
|---|
created_at |
string |
No |
2026-05-12T12:00:00Z |
|
|
device_name |
string |
No |
Chrome on Windows |
|
|
device_type |
string |
No |
web |
|
|
endpoint |
string |
No |
https://fcm.googleapis.com/fcm/send/... |
|
|
id |
string |
No |
sub-abc123 |
|
|
gitee_com_linmes_authms_base_dto.SimpleResponse
| Field | Type | Required | Example | Constraints | Description |
|---|
code |
integer |
No |
|
|
|
message |
string |
No |
|
|
|
timestamp |
string |
No |
|
|
|