POST `/push/subscriptions`

Register a Web Push subscription (RFC 8030 VAPID) to receive push notifications. Reference: CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance.

Notification Service `bearerAuth` application/json

Request Body

Schema: dto.PushSubscriptionRequest

Field	Type	Required	Example
`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

Responses

Status	Description	Schema
201	Registered successfully	`dto.PushSubscriptionDetailResponse`
400	Invalid request parameters	`gitee_com_linmes_authms_base_dto.SimpleResponse`
401	Unauthenticated	`gitee_com_linmes_authms_base_dto.SimpleResponse`
403	Insufficient permissions	`gitee_com_linmes_authms_base_dto.SimpleResponse`
404	Resource not found	`gitee_com_linmes_authms_base_dto.SimpleResponse`
500	Internal server error	`gitee_com_linmes_authms_base_dto.SimpleResponse`

Referenced Schemas

dto.PushSubscriptionDetailResponse

Field	Type	Required
`code`	`integer`	No
`data`	`dto.PushSubscriptionResponse`	No
`message`	`string`	No
`timestamp`	`string`	No

dto.PushSubscriptionKeys

Field	Type	Required	Example	Constraints	Description
`auth`	`string`	Yes	`xK2s9...`
`p256dh`	`string`	Yes	`BP7S2s9...`

dto.PushSubscriptionResponse

Field	Type	Required	Example
`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
`code`	`integer`	No
`message`	`string`	No
`timestamp`	`string`	No

Try this API in Scalar → Download OpenAPI spec (JSON) ↓

POST /push/subscriptions