GET /internal/communication/push/subscriptions

按显式 user_id 分页查询 Web Push 订阅

通信服务 - 内部接口 None application/json

请求参数

名称位置类型必填默认值示例约束描述
X-Tenant-ID header string 是 租户ID
user_id query string 是 用户ID
app_id query string 否 应用ID
page query integer 否 页码
page_size query integer 否 每页条数

响应

状态描述Schema
200查询成功service-communication/internal/handler/dto.PushSubscriptionListResponse
400请求参数错误dto.SimpleResponse
500服务内部错误dto.SimpleResponse

引用的 Schema

dto.PageInfo

字段类型必填示例约束描述
has_next boolean 否 HasNext indicates whether there is a next page
has_prev boolean 否 HasPrev indicates whether there is a previous page
page integer 否 Page is the current page number (1-based)
page_size integer 否 PageSize is the number of items per page
total integer 否 Total is the total number of items across all pages
total_pages integer 否 TotalPages is the total number of pages

dto.SimpleResponse

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

service-communication/internal/handler/dto.PushSubscriptionListResponse

字段类型必填示例约束描述
code integer 否
items array of

参见 service-communication/internal/handler/dto.PushSubscriptionResponse

否 统一使用 items
message string 否
pagination object 否 分页信息(嵌套对象)
timestamp string 否
total integer 否 总条数(平铺,便于直接读取)

service-communication/internal/handler/dto.PushSubscriptionResponse

Web Push 订阅信息

字段类型必填示例约束描述
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