{ "swagger": "2.0", "info": { "description": "通知服务，提供邮件、短信、推送等多种通知渠道的管理和发送功能", "title": "通知服务 API", "contact": {}, "version": "1.0.0" }, "basePath": "/bff/notification/api/v1", "paths": { "/admin/announcements": { "get": { "security": [ { "bearerAuth": [] } ], "description": "管理端分页查询本租户公告列表，支持按状态过滤和关键词搜索；与用户面 /announcements 同体（同租户范围），走 admin 受众供控制台读取 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "管理端列出公告", "parameters": [ { "type": "integer", "default": 1, "description": "页码", "name": "page", "in": "query" }, { "type": "integer", "default": 20, "description": "每页条数", "name": "page_size", "in": "query" }, { "type": "string", "description": "状态过滤: draft/scheduled/published/expired", "name": "status", "in": "query" }, { "type": "string", "description": "搜索关键词", "name": "search", "in": "query" } ], "responses": { "200": { "description": "公告列表", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.AnnouncementListResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } }, "post": { "security": [ { "bearerAuth": [] } ], "description": "创建新的公告，支持草稿/定时发布，可指定目标租户和角色 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "创建公告", "parameters": [ { "description": "创建公告请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.CreateAnnouncementRequest" } } ], "responses": { "201": { "description": "创建成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.AnnouncementDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/admin/announcements/{announcement_id}": { "put": { "security": [ { "bearerAuth": [] } ], "description": "编辑指定公告（仅在draft状态可编辑） 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "更新公告", "parameters": [ { "type": "string", "description": "公告ID", "name": "announcement_id", "in": "path", "required": true }, { "description": "更新公告请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.UpdateAnnouncementRequest" } } ], "responses": { "200": { "description": "更新成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.AnnouncementDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } }, "delete": { "security": [ { "bearerAuth": [] } ], "description": "删除指定公告（仅在draft状态可删除） 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "删除公告", "parameters": [ { "type": "string", "description": "公告ID", "name": "announcement_id", "in": "path", "required": true } ], "responses": { "200": { "description": "删除成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.SimpleResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/admin/announcements/{announcement_id}/publish": { "post": { "security": [ { "bearerAuth": [] } ], "description": "将公告从draft/scheduled状态发布为published，向目标用户推送通知 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "发布公告", "parameters": [ { "type": "string", "description": "公告ID", "name": "announcement_id", "in": "path", "required": true } ], "responses": { "200": { "description": "发布成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.AnnouncementDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/admin/announcements/{announcement_id}/unpublish": { "post": { "security": [ { "bearerAuth": [] } ], "description": "将已发布的公告撤回到草稿状态（unpublish） 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "撤回公告", "parameters": [ { "type": "string", "description": "公告ID", "name": "announcement_id", "in": "path", "required": true } ], "responses": { "200": { "description": "撤回成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.AnnouncementDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/admin/notifications": { "get": { "security": [ { "bearerAuth": [] } ], "description": "管理员按 user_id 查询指定用户的通知历史记录，支持按类型、已读状态、日期范围筛选", "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "管理员查看指定用户通知列表", "parameters": [ { "type": "string", "description": "用户ID", "name": "user_id", "in": "query", "required": true }, { "type": "integer", "description": "页码", "name": "page", "in": "query" }, { "type": "integer", "description": "每页条数", "name": "page_size", "in": "query" }, { "type": "string", "description": "通知类型", "name": "type", "in": "query" }, { "type": "boolean", "description": "是否已读", "name": "is_read", "in": "query" }, { "type": "string", "description": "开始日期", "name": "start_date", "in": "query" }, { "type": "string", "description": "结束日期", "name": "end_date", "in": "query" } ], "responses": { "200": { "description": "通知列表", "schema": { "$ref": "#/definitions/dto.ListResponse-gitee_com_autional_service-notification_internal_handler_dto_NotificationResponse" } }, "400": { "description": "缺少user_id参数", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/admin/notifications/broadcast": { "post": { "security": [ { "bearerAuth": [] } ], "description": "向租户下所有用户或指定用户群发送通知消息，适用于系统维护通知、安全告警等场景 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "广播通知", "parameters": [ { "description": "广播通知请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.BroadcastNotificationRequest" } } ], "responses": { "200": { "description": "广播发送成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.BroadcastNotificationDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/admin/notifications/event-mappings": { "get": { "security": [ { "bearerAuth": [] } ], "description": "与用户面 /notifications/event-mappings 同体、同租户范围；供控制台在 admin 平面读取。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "列出事件映射（管理端）", "responses": { "200": { "description": "事件映射列表", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.EventMappingListResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } }, "post": { "security": [ { "bearerAuth": [] } ], "description": "创建事件类型到通知模板的映射关系 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "创建事件映射", "parameters": [ { "description": "创建事件映射请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.CreateEventMappingRequest" } } ], "responses": { "201": { "description": "创建成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.EventMappingDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/admin/notifications/event-mappings/{announcement_id}": { "get": { "security": [ { "bearerAuth": [] } ], "description": "与用户面 /notifications/event-mappings/{announcement_id} 同体、同租户范围；供控制台在 admin 平面读取。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "获取事件映射详情（管理端）", "parameters": [ { "type": "string", "description": "事件映射ID", "name": "announcement_id", "in": "path", "required": true } ], "responses": { "200": { "description": "获取成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.EventMappingDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } }, "put": { "security": [ { "bearerAuth": [] } ], "description": "更新指定ID的事件映射配置 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "更新事件映射", "parameters": [ { "type": "string", "description": "事件映射ID", "name": "announcement_id", "in": "path", "required": true }, { "description": "更新事件映射请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.UpdateEventMappingRequest" } } ], "responses": { "200": { "description": "更新成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.EventMappingDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } }, "delete": { "security": [ { "bearerAuth": [] } ], "description": "删除指定ID的事件映射 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "删除事件映射", "parameters": [ { "type": "string", "description": "事件映射ID", "name": "announcement_id", "in": "path", "required": true } ], "responses": { "200": { "description": "删除成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.SimpleResponse" } } } } }, "/admin/notifications/global-variables": { "get": { "security": [ { "bearerAuth": [] } ], "description": "与用户面 /notifications/global-variables 同体、同租户范围；供控制台在 admin 平面读取。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "列出全局变量（管理端）", "responses": { "200": { "description": "全局变量列表", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.GlobalVariableListResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } }, "post": { "security": [ { "bearerAuth": [] } ], "description": "创建租户/应用级别的全局变量（如品牌名称、支持邮箱等） 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "创建全局变量", "parameters": [ { "description": "创建全局变量请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.CreateGlobalVariableRequest" } } ], "responses": { "201": { "description": "创建成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.GlobalVariableDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/admin/notifications/global-variables/{announcement_id}": { "get": { "security": [ { "bearerAuth": [] } ], "description": "与用户面 /notifications/global-variables/{announcement_id} 同体、同租户范围；供控制台在 admin 平面读取。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "获取全局变量（管理端）", "parameters": [ { "type": "string", "description": "全局变量ID", "name": "announcement_id", "in": "path", "required": true } ], "responses": { "200": { "description": "获取成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.GlobalVariableDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } }, "put": { "security": [ { "bearerAuth": [] } ], "description": "更新指定ID的全局变量值 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "更新全局变量", "parameters": [ { "type": "string", "description": "全局变量ID", "name": "announcement_id", "in": "path", "required": true }, { "description": "更新全局变量请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.UpdateGlobalVariableRequest" } } ], "responses": { "200": { "description": "更新成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.GlobalVariableDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } }, "delete": { "security": [ { "bearerAuth": [] } ], "description": "删除指定ID的全局变量 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "删除全局变量", "parameters": [ { "type": "string", "description": "全局变量ID", "name": "announcement_id", "in": "path", "required": true } ], "responses": { "200": { "description": "删除成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.SimpleResponse" } } } } }, "/admin/notifications/platform-stats": { "get": { "security": [ { "bearerAuth": [] } ], "description": "获取平台所有租户的通知发送、阅读等聚合统计数据 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "获取平台级通知统计", "responses": { "200": { "description": "统计结果", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.NotificationStatsDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/admin/notifications/preferences/{user_id}": { "put": { "security": [ { "bearerAuth": [] } ], "description": "管理员为指定用户设置通知渠道偏好（邮件/短信/Push等）", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "管理员覆盖用户通知偏好", "parameters": [ { "type": "string", "description": "用户ID", "name": "user_id", "in": "path", "required": true }, { "description": "偏好设置请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.NotificationPreferencesRequest" } } ], "responses": { "200": { "description": "偏好设置成功", "schema": { "$ref": "#/definitions/dto.DataResponse-gitee_com_autional_service-notification_internal_handler_dto_NotificationPreferencesResponse" } }, "400": { "description": "请求参数无效", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/admin/notifications/read-report": { "get": { "security": [ { "bearerAuth": [] } ], "description": "与用户面 /notifications/read-report 同体、同租户范围；供控制台在 admin 平面读取。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "获取通知已读报告（管理端）", "responses": { "200": { "description": "已读报告", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.ReadReportDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/admin/notifications/security-advisory-broadcast": { "post": { "security": [ { "bearerAuth": [] } ], "description": "向全部已确认（status=active）安全公告订阅者发送公告邮件，每封附该订户自己的退订链接。仅平台租户可调用（RequirePlatformTenant 门禁）。参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "合规管理 - Trust Center" ], "summary": "广播安全公告（平台级）", "parameters": [ { "description": "公告广播请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.SecurityAdvisoryBroadcastRequest" } } ], "responses": { "200": { "description": "广播完成", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.SecurityAdvisoryBroadcastDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "平台级访问受限", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/admin/notifications/stats": { "get": { "security": [ { "bearerAuth": [] } ], "description": "与用户面 /notifications/stats 同体、同租户范围；供控制台在 admin 平面读取。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "获取通知统计（管理端）", "responses": { "200": { "description": "统计结果", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.NotificationStatsDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/admin/notifications/templates": { "get": { "security": [ { "bearerAuth": [] } ], "description": "与用户面 /notifications/templates 同体、同租户范围；供控制台在 admin 平面读取。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "列出通知模板（管理端）", "parameters": [ { "type": "boolean", "description": "包含已停用模板", "name": "include_inactive", "in": "query" }, { "type": "string", "description": "通知类型过滤", "name": "type", "in": "query" }, { "type": "integer", "description": "页码（默认1）", "name": "page", "in": "query" }, { "type": "integer", "description": "每页条数（默认20）", "name": "page_size", "in": "query" } ], "responses": { "200": { "description": "模板列表", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.TemplateListResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } }, "post": { "security": [ { "bearerAuth": [] } ], "description": "创建一个新的通知模板，用于后续基于模板发送通知 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "创建通知模板", "parameters": [ { "description": "创建模板请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.CreateTemplateRequest" } } ], "responses": { "201": { "description": "创建成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.TemplateDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/admin/notifications/templates/{announcement_id}": { "get": { "security": [ { "bearerAuth": [] } ], "description": "与用户面 /notifications/templates/{announcement_id} 同体、同租户范围；供控制台在 admin 平面读取。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "获取通知模板详情（管理端）", "parameters": [ { "type": "string", "description": "模板ID", "name": "announcement_id", "in": "path", "required": true } ], "responses": { "200": { "description": "模板详情", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.TemplateDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } }, "put": { "security": [ { "bearerAuth": [] } ], "description": "更新指定ID的通知模板内容 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "更新通知模板", "parameters": [ { "type": "string", "description": "模板ID", "name": "announcement_id", "in": "path", "required": true }, { "description": "更新模板请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.UpdateTemplateRequest" } } ], "responses": { "200": { "description": "更新成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.TemplateDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } }, "delete": { "security": [ { "bearerAuth": [] } ], "description": "删除指定ID的通知模板 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "删除通知模板", "parameters": [ { "type": "string", "description": "模板ID", "name": "announcement_id", "in": "path", "required": true } ], "responses": { "200": { "description": "删除成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.SimpleResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/admin/notifications/templates/{announcement_id}/clone-to-locale": { "post": { "security": [ { "bearerAuth": [] } ], "description": "将指定模板复制到目标 locale，用于国际化支持 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "跨 locale 复制模板", "parameters": [ { "type": "string", "description": "模板ID", "name": "announcement_id", "in": "path", "required": true }, { "description": "跨locale复制请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.CloneTemplateToLocaleRequest" } } ], "responses": { "201": { "description": "复制成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.TemplateDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/admin/notifications/test": { "post": { "security": [ { "bearerAuth": [] } ], "description": "与用户面 /notifications/test 同体、同租户范围；供控制台在 admin 平面写入。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "发送测试通知（管理端）", "parameters": [ { "description": "测试通知请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.TestNotificationRequest" } } ], "responses": { "200": { "description": "测试通知已发送", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.TestNotificationDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/admin/notifications/trend": { "get": { "security": [ { "bearerAuth": [] } ], "description": "与用户面 /notifications/trend 同体、同租户范围；供控制台在 admin 平面读取。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "获取通知趋势（管理端）", "parameters": [ { "type": "integer", "description": "天数（默认30）", "name": "days", "in": "query" } ], "responses": { "200": { "description": "趋势数据", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.TrendResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/announcements": { "get": { "security": [ { "bearerAuth": [] } ], "description": "分页查询公告列表，支持按状态过滤和关键词搜索 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "列出公告", "parameters": [ { "type": "integer", "default": 1, "description": "页码", "name": "page", "in": "query" }, { "type": "integer", "default": 20, "description": "每页条数", "name": "page_size", "in": "query" }, { "type": "string", "description": "状态过滤: draft/scheduled/published/expired", "name": "status", "in": "query" }, { "type": "string", "description": "搜索关键词", "name": "search", "in": "query" } ], "responses": { "200": { "description": "公告列表", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.AnnouncementListResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/announcements/{announcement_id}": { "get": { "security": [ { "bearerAuth": [] } ], "description": "获取指定公告的详细信息，包含阅读统计（views/dismissals） 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "获取公告详情", "parameters": [ { "type": "string", "description": "公告ID", "name": "announcement_id", "in": "path", "required": true } ], "responses": { "200": { "description": "公告详情", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.AnnouncementDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/announcements/{announcement_id}/stats": { "get": { "security": [ { "bearerAuth": [] } ], "description": "获取指定公告的阅读/送达统计数据 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "获取公告统计", "parameters": [ { "type": "string", "description": "公告ID", "name": "announcement_id", "in": "path", "required": true } ], "responses": { "200": { "description": "统计结果", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.AnnouncementStatsDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/internal/notification/event-mappings": { "post": { "description": "内部 API：以 (tenant_id, app_id, event_type, channel) 为唯一键幂等 upsert 映射，\n供 seed/运维脚本收敛\"某事件应使用哪个模板\"。受 InternalAPIKeyMulti 保护。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务 - 内部接口" ], "summary": "内部种入事件→模板映射", "parameters": [ { "type": "string", "description": "租户ID", "name": "X-Tenant-ID", "in": "header", "required": true }, { "description": "映射种入请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.InternalUpsertEventMappingRequest" } } ], "responses": { "200": { "description": "写入成功", "schema": { "$ref": "#/definitions/dto.DataResponse-gitee_com_autional_service-notification_internal_handler_dto_EventMappingResponse" } }, "400": { "description": "请求参数无效", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未提供有效的X-API-Key", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/internal/notification/export-user-data": { "post": { "description": "按租户和用户ID导出所有通知记录和偏好设置（GDPR合规数据导出） 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务 - 内部接口" ], "summary": "导出用户数据", "parameters": [ { "type": "string", "description": "租户ID", "name": "X-Tenant-ID", "in": "header", "required": true }, { "description": "导出数据请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.ExportUserDataRequest" } } ], "responses": { "200": { "description": "导出成功", "schema": { "$ref": "#/definitions/dto.DataResponse-gitee_com_autional_service-notification_internal_handler_dto_ExportUserDataResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/internal/notification/notifications/erase-user": { "post": { "description": "根据compliance-service erasure流程，擦除指定用户的所有通知数据。内部API，受InternalAPIKeyMulti保护。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务 - 内部接口" ], "summary": "GDPR擦除用户通知", "parameters": [ { "type": "string", "description": "租户ID", "name": "X-Tenant-ID", "in": "header", "required": true }, { "description": "擦除请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.EraseUserNotificationsRequest" } } ], "responses": { "200": { "description": "擦除成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "400": { "description": "请求参数无效", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未提供有效的X-API-Key", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/internal/notification/notifications/send-by-event": { "post": { "description": "内部API，根据事件类型向指定用户发送通知。受InternalAPIKeyMulti + ExtractTenantFromHeaderStrict保护。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务 - 内部接口" ], "summary": "根据事件类型发送通知", "parameters": [ { "type": "string", "description": "租户ID", "name": "X-Tenant-ID", "in": "header", "required": true }, { "description": "事件通知请求 {event_type:string, user_id:string, variables:map, metadata:map}", "name": "request", "in": "body", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "发送成功", "schema": { "$ref": "#/definitions/dto.DataResponse-gitee_com_autional_service-notification_internal_handler_dto_NotificationResponse" } }, "400": { "description": "请求参数无效", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未提供有效的X-API-Key", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "429": { "description": "频率限制", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/internal/notification/push/send": { "post": { "description": "向指定用户的设备发送 VAPID 签名的 Web Push 通知消息（内部API，投递由 communication-service 执行） 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务 - 内部接口" ], "summary": "内部推送通知发送", "parameters": [ { "type": "string", "description": "租户ID", "name": "X-Tenant-ID", "in": "header", "required": true }, { "description": "内部推送发送请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.InternalPushSendRequest" } } ], "responses": { "200": { "description": "发送成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.PushSendDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/internal/notification/send-external": { "post": { "description": "内部 API：按模板 code 渲染后投递 email/sms（不创建站内通知）。\n供无用户上下文的路径使用：Trust Center 订阅确认/退订、状态页订阅双确认（A5/A6）。\n受 InternalAPIKeyMulti + X-Tenant-ID 保护；locale 缺省 zh-CN。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务 - 内部接口" ], "summary": "内部模板化外部投递", "parameters": [ { "type": "string", "description": "租户ID", "name": "X-Tenant-ID", "in": "header", "required": true }, { "description": "外部投递请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.InternalSendExternalRequest" } } ], "responses": { "200": { "description": "已入队", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "400": { "description": "请求参数无效", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未提供有效的X-API-Key", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "模板未找到或未启用", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/internal/notification/templates": { "post": { "description": "内部API，由seed脚本调用，通过请求体直接传入模板title、locale等信息创建模板。受InternalAPIKeyMulti保护。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务 - 内部接口" ], "summary": "内部创建通知模板", "parameters": [ { "description": "创建模板请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.InternalCreateTemplateRequest" } } ], "responses": { "201": { "description": "创建成功", "schema": { "$ref": "#/definitions/dto.DataResponse-gitee_com_autional_service-notification_internal_handler_dto_TemplateResponse" } }, "400": { "description": "请求参数无效", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未提供有效的X-API-Key", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/internal/runtime": { "get": { "description": "返回服务运行时信息，包括调度器状态、版本号、运行时长等（内部API）。受InternalAPIKeyMulti保护。", "produces": [ "application/json" ], "tags": [ "通知服务 - 内部接口" ], "summary": "Runtime信息", "responses": { "200": { "description": "运行时信息", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未提供有效的X-API-Key", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "健康检查服务不可用", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/internal/runtime/ready": { "get": { "security": [ { "ApiKeyAuth": [] } ], "description": "内部 API：组件级就绪检查（DB、Redis 等），返回各组件健康状态。受 InternalAPIKeyMulti 保护。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务 - 内部接口" ], "summary": "就绪检查", "responses": { "200": { "description": "组件健康状态", "schema": { "$ref": "#/definitions/dto.DataResponse-map_string_string" } }, "503": { "description": "组件不可用", "schema": { "$ref": "#/definitions/dto.DataResponse-handler_HealthErrorResponse" } } } } }, "/notifications": { "get": { "security": [ { "bearerAuth": [] } ], "description": "查询当前用户收到的通知列表，支持仅查询未读选项 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "获取通知列表", "parameters": [ { "type": "boolean", "description": "仅查询未读通知", "name": "unread_only", "in": "query" }, { "type": "integer", "description": "页码", "name": "page", "in": "query" }, { "type": "integer", "description": "每页条数", "name": "page_size", "in": "query" } ], "responses": { "200": { "description": "通知列表", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.NotificationListResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } }, "post": { "security": [ { "bearerAuth": [] } ], "description": "向指定用户发送一条通知消息，支持多种通知类型，记录发送状态并触发事件通知 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "发送通知", "parameters": [ { "description": "发送通知请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.SendNotificationRequest" } } ], "responses": { "201": { "description": "发送成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.NotificationDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/notifications/event-mappings": { "get": { "security": [ { "bearerAuth": [] } ], "description": "获取当前租户的所有事件映射列表 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "列出事件映射", "responses": { "200": { "description": "事件映射列表", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.EventMappingListResponse" } } } } }, "/notifications/event-mappings/{announcement_id}": { "get": { "security": [ { "bearerAuth": [] } ], "description": "获取指定ID的事件映射详情 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "获取事件映射", "parameters": [ { "type": "string", "description": "事件映射ID", "name": "announcement_id", "in": "path", "required": true } ], "responses": { "200": { "description": "获取成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.EventMappingDetailResponse" } } } } }, "/notifications/global-variables": { "get": { "security": [ { "bearerAuth": [] } ], "description": "获取当前租户的所有全局变量列表 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "列出全局变量", "responses": { "200": { "description": "全局变量列表", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.GlobalVariableListResponse" } } } } }, "/notifications/global-variables/{announcement_id}": { "get": { "security": [ { "bearerAuth": [] } ], "description": "获取指定ID的全局变量详情 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "获取全局变量", "parameters": [ { "type": "string", "description": "全局变量ID", "name": "announcement_id", "in": "path", "required": true } ], "responses": { "200": { "description": "获取成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.GlobalVariableDetailResponse" } } } } }, "/notifications/preferences/{user_id}": { "get": { "security": [ { "bearerAuth": [] } ], "description": "获取指定用户的通知接收偏好，包括各渠道开关、免打扰时段等设置 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "获取通知偏好设置", "parameters": [ { "type": "string", "description": "用户ID", "name": "user_id", "in": "path", "required": true } ], "responses": { "200": { "description": "偏好设置", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.NotificationPreferencesDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } }, "put": { "security": [ { "bearerAuth": [] } ], "description": "更新指定用户的通知接收偏好，包括App内通知、邮件、短信、推送等渠道的开关控制 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "更新通知偏好设置", "parameters": [ { "type": "string", "description": "用户ID", "name": "user_id", "in": "path", "required": true }, { "description": "偏好设置", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.NotificationPreferencesRequest" } } ], "responses": { "200": { "description": "更新成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.NotificationPreferencesDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/notifications/public/security-confirm": { "get": { "description": "Trust Center公开端点，用户点击邮件中的确认链接后调用此端点完成订阅确认。需要email和token参数。受IP级别频率限制保护。", "produces": [ "application/json" ], "tags": [ "合规管理 - Trust Center" ], "summary": "确认安全公告订阅", "parameters": [ { "type": "string", "description": "订阅邮箱", "name": "email", "in": "query", "required": true }, { "type": "string", "description": "确认令牌", "name": "token", "in": "query", "required": true } ], "responses": { "200": { "description": "确认成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "400": { "description": "缺少email或token", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "429": { "description": "频率限制", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/notifications/public/security-subscribe": { "post": { "description": "Trust Center: 公开订阅安全公告和合规更新（无认证） 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "合规管理 - Trust Center" ], "summary": "订阅安全公告", "parameters": [ { "description": "订阅请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.SecuritySubscribeRequest" } } ], "responses": { "200": { "description": "订阅成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.SecuritySubscribeDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/notifications/public/security-unsubscribe": { "post": { "description": "Trust Center: 公开退订安全公告（无认证） 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "合规管理 - Trust Center" ], "summary": "退订安全公告", "parameters": [ { "description": "退订请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.SecurityUnsubscribeRequest" } } ], "responses": { "200": { "description": "退订成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.SecurityUnsubscribeDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/notifications/read-all": { "put": { "security": [ { "bearerAuth": [] } ], "description": "将当前用户的所有未读通知一次性标记为已读状态 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "标记全部通知已读", "responses": { "200": { "description": "全部标记成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.SimpleResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/notifications/read-report": { "get": { "security": [ { "bearerAuth": [] } ], "description": "基于数据库中真实通知记录统计已读数、未读数、阅读率等运营指标 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "获取通知已读/未读报告", "responses": { "200": { "description": "已读报告", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.ReadReportDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/notifications/send": { "post": { "security": [ { "bearerAuth": [] } ], "description": "与 /notifications 相同功能的兼容端点，向指定用户发送通知 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "发送通知（兼容端点）", "parameters": [ { "description": "发送通知请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.SendNotificationRequest" } } ], "responses": { "200": { "description": "发送成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.SendNotificationCompatDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/notifications/send-batch": { "post": { "security": [ { "bearerAuth": [] } ], "description": "向多个用户同时发送相同的通知消息，适用于系统公告、运营活动等场景 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "批量发送通知", "parameters": [ { "description": "批量发送通知请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.BatchSendNotificationRequest" } } ], "responses": { "201": { "description": "批量发送成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.BatchSendNotificationDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/notifications/send-from-template": { "post": { "security": [ { "bearerAuth": [] } ], "description": "使用指定模板向用户发送通知，支持模板变量替换 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "使用模板发送通知", "parameters": [ { "description": "使用模板发送请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.SendFromTemplateRequest" } } ], "responses": { "200": { "description": "发送成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.NotificationDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/notifications/stats": { "get": { "security": [ { "bearerAuth": [] } ], "description": "获取当前租户的通知发送、送达、阅读等聚合统计数据 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "获取通知统计", "responses": { "200": { "description": "统计结果", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.NotificationStatsDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/notifications/stream": { "get": { "security": [ { "bearerAuth": [] } ], "description": "通过Server-Sent Events实时推送通知。P5-4：经 POST /notifications/stream-ticket 换取一次性票据后以 ?ticket= 建流（浏览器 EventSource 主路径）；非浏览器客户端可走 Authorization 头 JWT（?token= 兼容回退已删除）。订阅身份以认证上下文（票据/JWT claims）为准。 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "text/event-stream" ], "tags": [ "通知服务" ], "summary": "SSE实时通知流", "parameters": [ { "type": "string", "description": "一次性短期票据（P5-4 主路径，60s 内一次性消费）", "name": "ticket", "in": "query" }, { "type": "string", "description": "用户ID（已弃用回退：仅在认证上下文无用户时使用）", "name": "user_id", "in": "query" } ], "responses": { "200": { "description": "SSE事件流" }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/notifications/stream-ticket": { "post": { "security": [ { "bearerAuth": [] } ], "description": "为 /notifications/stream 签发一次性票据（P5-4）：浏览器 EventSource 不能携带 Authorization 头，故以 JWT 保护的本端点换取 60s 一次性票据，再以 ?ticket= 建流，避免 access token 进入 URL/接入日志。需 JWT 认证（正常 Authorization 头调用）。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "签发 SSE 短期票据", "responses": { "200": { "description": "票据签发成功", "schema": { "$ref": "#/definitions/dto.DataResponse-gitee_com_autional_service-notification_internal_handler_dto_StreamTicketResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/notifications/templates": { "get": { "security": [ { "bearerAuth": [] } ], "description": "获取所有通知模板列表，支持包含已停用模板的选项 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "列出通知模板", "parameters": [ { "type": "boolean", "description": "包含已停用模板", "name": "include_inactive", "in": "query" }, { "type": "string", "description": "通知类型过滤", "name": "type", "in": "query" }, { "type": "integer", "description": "页码（默认1）", "name": "page", "in": "query" }, { "type": "integer", "description": "每页条数（默认20）", "name": "page_size", "in": "query" } ], "responses": { "200": { "description": "模板列表", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.TemplateListResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/notifications/templates/available": { "get": { "security": [ { "bearerAuth": [] } ], "description": "返回平台默认模板和本租户自定义模板的聚合列表 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "列出可用模板", "responses": { "200": { "description": "可用模板列表", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.AvailableTemplateListResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/notifications/templates/{announcement_id}": { "get": { "security": [ { "bearerAuth": [] } ], "description": "获取指定ID的通知模板详情 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "获取通知模板", "parameters": [ { "type": "string", "description": "模板ID", "name": "announcement_id", "in": "path", "required": true } ], "responses": { "200": { "description": "模板详情", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.TemplateDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/notifications/test": { "post": { "security": [ { "bearerAuth": [] } ], "description": "向指定渠道和目标发送一条测试通知，创建测试通知记录到数据库，用于验证通知服务配置是否正确 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "发送测试通知", "parameters": [ { "description": "测试通知请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.TestNotificationRequest" } } ], "responses": { "200": { "description": "测试通知已发送", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.TestNotificationDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/notifications/trend": { "get": { "security": [ { "bearerAuth": [] } ], "description": "返回指定天数内每日通知发送量和已读量的趋势数据 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "获取通知趋势", "parameters": [ { "type": "integer", "description": "天数（默认30）", "name": "days", "in": "query" } ], "responses": { "200": { "description": "趋势数据", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.TrendResponse" } } } } }, "/notifications/unread": { "get": { "security": [ { "bearerAuth": [] } ], "description": "获取当前用户的所有未读通知列表 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "获取未读通知列表", "responses": { "200": { "description": "未读通知列表", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.NotificationListResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/notifications/unread-count": { "get": { "security": [ { "bearerAuth": [] } ], "description": "获取当前用户的未读通知数量及最后通知时间 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "获取未读通知数量", "responses": { "200": { "description": "未读计数", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.UnreadCountDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/notifications/{notification_id}": { "get": { "security": [ { "bearerAuth": [] } ], "description": "获取指定通知的详细信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "获取通知详情", "parameters": [ { "type": "string", "description": "通知ID", "name": "notification_id", "in": "path", "required": true } ], "responses": { "200": { "description": "通知详情", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.NotificationDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } }, "delete": { "security": [ { "bearerAuth": [] } ], "description": "删除指定ID的通知记录（软验证用户ID匹配） 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "删除通知", "parameters": [ { "type": "string", "description": "通知ID", "name": "notification_id", "in": "path", "required": true }, { "description": "删除通知请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.DeleteNotificationRequest" } } ], "responses": { "200": { "description": "删除成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.DeleteNotificationDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/notifications/{notification_id}/read": { "put": { "security": [ { "bearerAuth": [] } ], "description": "将指定通知标记为已读状态，记录已读时间 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "标记通知已读", "parameters": [ { "type": "string", "description": "通知ID", "name": "notification_id", "in": "path", "required": true } ], "responses": { "200": { "description": "标记成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.MarkReadDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/notifications/{notification_id}/unread": { "put": { "security": [ { "bearerAuth": [] } ], "description": "将指定通知标记为未读状态 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "标记通知未读", "parameters": [ { "type": "string", "description": "通知ID", "name": "notification_id", "in": "path", "required": true } ], "responses": { "200": { "description": "标记成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.SimpleResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/push/subscriptions": { "get": { "security": [ { "bearerAuth": [] } ], "description": "查询当前用户的 Web Push 订阅列表 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "列出推送订阅", "responses": { "200": { "description": "订阅列表", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.PushSubscriptionListResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } }, "post": { "security": [ { "bearerAuth": [] } ], "description": "注册 Web Push 订阅（RFC 8030 VAPID），用于接收推送通知 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "注册 Web Push 推送订阅", "parameters": [ { "description": "推送订阅请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.PushSubscriptionRequest" } } ], "responses": { "201": { "description": "注册成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.PushSubscriptionDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } }, "delete": { "security": [ { "bearerAuth": [] } ], "description": "根据 endpoint 删除 Web Push 订阅 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "删除推送订阅", "parameters": [ { "type": "string", "description": "订阅端点URL", "name": "endpoint", "in": "query", "required": true } ], "responses": { "200": { "description": "删除成功", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/push/subscriptions/{subscription_id}": { "get": { "security": [ { "bearerAuth": [] } ], "description": "根据ID查询 Web Push 订阅详情", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "获取推送订阅详情", "parameters": [ { "type": "string", "description": "订阅ID", "name": "subscription_id", "in": "path", "required": true } ], "responses": { "200": { "description": "订阅详情", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.PushSubscriptionDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } }, "/push/vapid-public-key": { "get": { "description": "返回 Web Push VAPID 公钥，供前端注册 Push 订阅时使用（来源：communication-service） 参考：CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "通知服务" ], "summary": "获取 VAPID 公钥", "responses": { "200": { "description": "VAPID 公钥", "schema": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.VapidPublicKeyDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } }, "500": { "description": "服务内部错误", "schema": { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.SimpleResponse" } } } } } }, "definitions": { "dto.DataResponse-gitee_com_autional_service-notification_internal_handler_dto_EventMappingResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.EventMappingResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.DataResponse-gitee_com_autional_service-notification_internal_handler_dto_ExportUserDataResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.ExportUserDataResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.DataResponse-gitee_com_autional_service-notification_internal_handler_dto_NotificationPreferencesResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.NotificationPreferencesResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.DataResponse-gitee_com_autional_service-notification_internal_handler_dto_NotificationResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.NotificationResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.DataResponse-gitee_com_autional_service-notification_internal_handler_dto_StreamTicketResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.StreamTicketResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.DataResponse-gitee_com_autional_service-notification_internal_handler_dto_TemplateResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.TemplateResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.DataResponse-handler_HealthErrorResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/handler.HealthErrorResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.DataResponse-map_string_string": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/map_string_string" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.ListResponse-gitee_com_autional_service-notification_internal_handler_dto_NotificationResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "items": { "description": "统一使用 items", "type": "array", "items": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.NotificationResponse" } }, "message": { "type": "string" }, "pagination": { "description": "分页信息（嵌套对象）", "allOf": [ { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.PageInfo" } ] }, "timestamp": { "type": "string" }, "total": { "description": "总条数（平铺，便于直接读取）", "type": "integer" } } }, "gitee_com_autional_service-core_base_dto.PageInfo": { "type": "object", "properties": { "has_next": { "description": "HasNext indicates whether there is a next page", "type": "boolean" }, "has_prev": { "description": "HasPrev indicates whether there is a previous page", "type": "boolean" }, "page": { "description": "Page is the current page number (1-based)", "type": "integer" }, "page_size": { "description": "PageSize is the number of items per page", "type": "integer" }, "total": { "description": "Total is the total number of items across all pages", "type": "integer" }, "total_pages": { "description": "TotalPages is the total number of pages", "type": "integer" } } }, "gitee_com_autional_service-core_base_dto.SimpleResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.AnnouncementDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.AnnouncementResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.AnnouncementListResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "items": { "description": "统一使用 items", "type": "array", "items": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.AnnouncementResponse" } }, "message": { "type": "string" }, "pagination": { "description": "分页信息（嵌套对象）", "allOf": [ { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.PageInfo" } ] }, "timestamp": { "type": "string" }, "total": { "description": "总条数（平铺，便于直接读取）", "type": "integer" } } }, "gitee_com_autional_service-notification_internal_handler_dto.AnnouncementResponse": { "description": "公告信息响应", "type": "object", "properties": { "content": { "type": "string", "example": "系统将于2026-05-15进行升级维护" }, "created_at": { "type": "string", "example": "2026-05-09T12:00:00Z" }, "dismissals": { "type": "integer", "example": 5 }, "expire_at": { "type": "string", "example": "2026-05-20T12:00:00Z" }, "id": { "type": "string", "example": "ann_abc123" }, "publish_at": { "type": "string", "example": "2026-05-10T12:00:00Z" }, "status": { "type": "string", "example": "published" }, "target_roles": { "type": "array", "items": { "type": "string" } }, "tenant_id": { "type": "string", "example": "tnt_xyz789" }, "title": { "type": "string", "example": "系统升级公告" }, "updated_at": { "type": "string", "example": "2026-05-09T12:00:00Z" }, "views": { "type": "integer", "example": 100 } } }, "gitee_com_autional_service-notification_internal_handler_dto.AnnouncementStatsDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.AnnouncementStatsResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.AnnouncementStatsResponse": { "description": "公告阅读统计", "type": "object", "properties": { "dismissals": { "type": "integer", "example": 5 }, "views": { "type": "integer", "example": 100 } } }, "gitee_com_autional_service-notification_internal_handler_dto.AvailableTemplateListResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "items": { "description": "统一使用 items", "type": "array", "items": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.AvailableTemplateResponse" } }, "message": { "type": "string" }, "pagination": { "description": "分页信息（嵌套对象）", "allOf": [ { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.PageInfo" } ] }, "timestamp": { "type": "string" }, "total": { "description": "总条数（平铺，便于直接读取）", "type": "integer" } } }, "gitee_com_autional_service-notification_internal_handler_dto.AvailableTemplateResponse": { "type": "object", "properties": { "channel": { "type": "string", "example": "in_app" }, "code": { "type": "string", "example": "welcome" }, "is_customized": { "type": "boolean", "example": false }, "locale": { "type": "string", "example": "zh-CN" }, "name": { "type": "string", "example": "欢迎通知" }, "source": { "description": "platform | tenant", "type": "string", "example": "platform" }, "status": { "type": "string", "example": "active" }, "title": { "type": "string" }, "variables": { "type": "array", "items": { "type": "string" } } } }, "gitee_com_autional_service-notification_internal_handler_dto.BatchSendNotificationDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.BatchSendNotificationResponse" }, "message": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.BatchSendNotificationRequest": { "description": "批量发送通知请求参数", "type": "object", "required": [ "content", "title", "user_ids" ], "properties": { "content": { "description": "内容", "type": "string", "example": "您的账户已成功升级" }, "priority": { "description": "优先级", "type": "string", "example": "medium" }, "title": { "description": "标题", "type": "string", "example": "系统通知" }, "type": { "description": "类型", "type": "string", "example": "system" }, "user_ids": { "description": "用户ID列表", "type": "array", "items": { "type": "string" }, "example": [ "usr_001", "usr_002" ] } } }, "gitee_com_autional_service-notification_internal_handler_dto.BatchSendNotificationResponse": { "description": "批量发送通知结果", "type": "object", "properties": { "notification_ids": { "description": "通知ID列表", "type": "array", "items": { "type": "string" }, "example": [ "[\"ntf_001\"]" ] }, "sent_count": { "description": "发送数量", "type": "integer", "example": 5 } } }, "gitee_com_autional_service-notification_internal_handler_dto.BroadcastNotificationDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.BroadcastNotificationResponse" }, "message": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.BroadcastNotificationRequest": { "description": "全租户广播通知的请求参数", "type": "object", "required": [ "content", "title" ], "properties": { "content": { "description": "内容", "type": "string", "example": "系统将于今晚22:00-23:00进行维护" }, "title": { "description": "标题", "type": "string", "example": "系统公告" }, "type": { "description": "类型", "type": "string", "example": "system" } } }, "gitee_com_autional_service-notification_internal_handler_dto.BroadcastNotificationResponse": { "description": "广播通知的响应结果", "type": "object", "properties": { "broadcast_id": { "description": "广播ID", "type": "string", "example": "broadcast-1234567890" }, "content": { "description": "内容", "type": "string", "example": "系统将于今晚22:00-23:00进行维护" }, "recipients": { "description": "接收人数", "type": "integer", "example": 100 }, "title": { "description": "标题", "type": "string", "example": "系统公告" }, "type": { "description": "类型", "type": "string", "example": "system" } } }, "gitee_com_autional_service-notification_internal_handler_dto.ChannelPref": { "description": "单个通知渠道的偏好", "type": "object", "properties": { "enabled": { "description": "启用", "type": "boolean", "example": true }, "quiet_hours_end": { "description": "免打扰结束", "type": "string", "example": "08:00" }, "quiet_hours_start": { "description": "免打扰开始", "type": "string", "example": "22:00" }, "types": { "description": "类型", "type": "array", "items": { "type": "string" }, "example": [ "[\"system\"", "\"user\"]" ] } } }, "gitee_com_autional_service-notification_internal_handler_dto.ChannelPrefResponse": { "description": "渠道偏好响应", "type": "object", "properties": { "enabled": { "description": "启用", "type": "boolean", "example": true }, "quiet_hours_end": { "description": "免打扰结束", "type": "string", "example": "08:00" }, "quiet_hours_start": { "description": "免打扰开始", "type": "string", "example": "22:00" }, "types": { "description": "类型", "type": "array", "items": { "type": "string" } } } }, "gitee_com_autional_service-notification_internal_handler_dto.CloneTemplateToLocaleRequest": { "type": "object", "required": [ "target_locale" ], "properties": { "content": { "type": "string" }, "target_locale": { "type": "string", "example": "en-US" }, "title": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.CreateAnnouncementRequest": { "description": "创建公告的请求参数", "type": "object", "required": [ "content", "title" ], "properties": { "content": { "type": "string", "example": "系统将于2026-05-15进行升级维护" }, "expire_at": { "type": "string", "example": "2026-05-20T12:00:00Z" }, "publish_at": { "type": "string", "example": "2026-05-10T12:00:00Z" }, "target_roles": { "type": "array", "items": { "type": "string" } }, "title": { "type": "string", "example": "系统升级公告" } } }, "gitee_com_autional_service-notification_internal_handler_dto.CreateEventMappingRequest": { "type": "object", "required": [ "event_type", "template_code" ], "properties": { "channel": { "type": "string" }, "event_type": { "type": "string" }, "priority": { "type": "string" }, "template_code": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.CreateGlobalVariableRequest": { "type": "object", "required": [ "key", "value" ], "properties": { "key": { "type": "string" }, "value": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.CreateTemplateRequest": { "description": "创建通知模板请求参数", "type": "object", "required": [ "code", "content", "name", "subject", "type" ], "properties": { "code": { "type": "string", "example": "welcome_notification" }, "content": { "type": "string", "example": "亲爱的{{user_name}}" }, "format": { "type": "string", "example": "simple" }, "name": { "type": "string", "example": "welcome_notification" }, "subject": { "type": "string", "example": "欢迎加入{{app_name}}" }, "type": { "type": "string", "example": "system" }, "variables": { "type": "array", "items": { "type": "string" }, "example": [ "[\"user_name\"]" ] } } }, "gitee_com_autional_service-notification_internal_handler_dto.DeleteNotificationDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.DeleteNotificationResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.DeleteNotificationRequest": { "description": "删除通知请求参数", "type": "object", "required": [ "notification_id", "user_id" ], "properties": { "notification_id": { "description": "通知ID", "type": "string", "example": "ntf_abc123" }, "user_id": { "description": "用户ID", "type": "string", "example": "usr_abc123" } } }, "gitee_com_autional_service-notification_internal_handler_dto.DeleteNotificationResponse": { "description": "删除通知结果", "type": "object", "properties": { "deleted": { "description": "删除成功", "type": "boolean", "example": true }, "notification_id": { "description": "通知ID", "type": "string", "example": "ntf_abc123" } } }, "gitee_com_autional_service-notification_internal_handler_dto.EraseUserNotificationsRequest": { "type": "object", "required": [ "user_id" ], "properties": { "user_id": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.EventMappingDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.EventMappingResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.EventMappingListResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "items": { "description": "统一使用 items", "type": "array", "items": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.EventMappingResponse" } }, "message": { "type": "string" }, "pagination": { "description": "分页信息（嵌套对象）", "allOf": [ { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.PageInfo" } ] }, "timestamp": { "type": "string" }, "total": { "description": "总条数（平铺，便于直接读取）", "type": "integer" } } }, "gitee_com_autional_service-notification_internal_handler_dto.EventMappingResponse": { "type": "object", "properties": { "app_id": { "type": "string" }, "channel": { "type": "string" }, "event_type": { "type": "string" }, "id": { "type": "string" }, "is_enabled": { "type": "boolean" }, "priority": { "type": "string" }, "template_code": { "type": "string" }, "tenant_id": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.ExportUserDataRequest": { "type": "object", "required": [ "user_id" ], "properties": { "user_id": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.ExportUserDataResponse": { "type": "object", "properties": { "notifications": { "type": "array", "items": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.NotificationResponse" } }, "preferences": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.NotificationPreferencesResponse" } } }, "gitee_com_autional_service-notification_internal_handler_dto.GlobalVariableDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.GlobalVariableResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.GlobalVariableListResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "items": { "description": "统一使用 items", "type": "array", "items": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.GlobalVariableResponse" } }, "message": { "type": "string" }, "pagination": { "description": "分页信息（嵌套对象）", "allOf": [ { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.PageInfo" } ] }, "timestamp": { "type": "string" }, "total": { "description": "总条数（平铺，便于直接读取）", "type": "integer" } } }, "gitee_com_autional_service-notification_internal_handler_dto.GlobalVariableResponse": { "type": "object", "properties": { "app_id": { "type": "string" }, "id": { "type": "string" }, "key": { "type": "string" }, "tenant_id": { "type": "string" }, "value": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.InternalCreateTemplateRequest": { "type": "object", "properties": { "code": { "type": "string" }, "content": { "type": "string" }, "format": { "type": "string" }, "locale": { "type": "string" }, "name": { "type": "string" }, "priority": { "type": "string" }, "title": { "type": "string" }, "type": { "type": "string" }, "variables": { "type": "array", "items": { "type": "string" } } } }, "gitee_com_autional_service-notification_internal_handler_dto.InternalPushSendRequest": { "type": "object", "required": [ "body", "title" ], "properties": { "body": { "type": "string", "example": "Login from Beijing - Approve?" }, "data": { "type": "object", "additionalProperties": true }, "title": { "type": "string", "example": "New Login Attempt" }, "user_id": { "type": "string", "example": "user-001" } } }, "gitee_com_autional_service-notification_internal_handler_dto.InternalSendExternalRequest": { "type": "object", "required": [ "channel", "recipient", "template_code" ], "properties": { "channel": { "type": "string", "example": "email" }, "locale": { "type": "string", "example": "en-US" }, "recipient": { "type": "string", "example": "user@example.com" }, "template_code": { "type": "string", "example": "status_subscription_confirm" }, "variables": { "type": "object", "additionalProperties": { "type": "string" } } } }, "gitee_com_autional_service-notification_internal_handler_dto.InternalUpsertEventMappingRequest": { "type": "object", "required": [ "event_type", "template_code" ], "properties": { "channel": { "description": "空 → in_app", "type": "string", "example": "in_app" }, "event_type": { "type": "string", "example": "user.registered" }, "is_enabled": { "description": "空 → true", "type": "boolean" }, "priority": { "description": "空 → medium", "type": "string", "example": "medium" }, "template_code": { "type": "string", "example": "welcome" } } }, "gitee_com_autional_service-notification_internal_handler_dto.MarkReadDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.MarkReadResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.MarkReadResponse": { "description": "标记已读结果", "type": "object", "properties": { "marked_count": { "description": "标记数量", "type": "integer", "example": 5 }, "success": { "description": "成功", "type": "boolean", "example": true } } }, "gitee_com_autional_service-notification_internal_handler_dto.NotificationDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.NotificationResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.NotificationListResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "items": { "description": "统一使用 items", "type": "array", "items": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.NotificationResponse" } }, "message": { "type": "string" }, "pagination": { "description": "分页信息（嵌套对象）", "allOf": [ { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.PageInfo" } ] }, "timestamp": { "type": "string" }, "total": { "description": "总条数（平铺，便于直接读取）", "type": "integer" } } }, "gitee_com_autional_service-notification_internal_handler_dto.NotificationPreferencesDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.NotificationPreferencesResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.NotificationPreferencesRequest": { "description": "更新通知偏好设置请求参数", "type": "object", "required": [ "user_id" ], "properties": { "channels": { "description": "渠道设置", "type": "object", "additionalProperties": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.ChannelPref" } }, "email_enabled": { "description": "邮件启用", "type": "boolean", "example": true }, "push_enabled": { "description": "推送启用", "type": "boolean", "example": true }, "sms_enabled": { "description": "短信启用", "type": "boolean", "example": false }, "user_id": { "description": "用户ID", "type": "string", "example": "usr_abc123" } } }, "gitee_com_autional_service-notification_internal_handler_dto.NotificationPreferencesResponse": { "description": "用户通知偏好设置", "type": "object", "properties": { "channels": { "description": "渠道设置", "type": "object", "additionalProperties": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.ChannelPrefResponse" } }, "email_enabled": { "description": "邮件启用", "type": "boolean", "example": true }, "push_enabled": { "description": "推送启用", "type": "boolean", "example": true }, "quiet_hours": { "description": "免打扰时段", "type": "object", "additionalProperties": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.ChannelPrefResponse" } }, "sms_enabled": { "description": "短信启用", "type": "boolean", "example": false }, "type_prefs": { "description": "通知类型偏好", "type": "object", "additionalProperties": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.ChannelPrefResponse" } }, "updated_at": { "description": "更新时间", "type": "string", "example": "2026-04-15T10:30:00Z" }, "user_id": { "description": "用户ID", "type": "string", "example": "usr_abc123" } } }, "gitee_com_autional_service-notification_internal_handler_dto.NotificationResponse": { "description": "通知信息响应", "type": "object", "properties": { "action_url": { "description": "操作链接", "type": "string", "example": "/security" }, "content": { "description": "内容", "type": "string", "example": "您的账户已成功升级" }, "created_at": { "description": "创建时间", "type": "string", "example": "2026-04-15T10:30:00Z" }, "event_type": { "type": "string", "example": "status.incident.created" }, "id": { "description": "通知ID", "type": "string", "example": "ntf_abc123" }, "is_read": { "description": "是否已读", "type": "boolean", "example": false }, "metadata": { "description": "元数据JSON", "type": "string", "example": "{\"ip\":\"1.2.3.4\"}" }, "priority": { "description": "优先级", "type": "string", "example": "medium" }, "read_at": { "description": "阅读时间", "type": "string", "example": "2026-04-15T11:00:00Z" }, "tenant_id": { "description": "租户ID", "type": "string", "example": "tnt_xyz789" }, "title": { "description": "标题", "type": "string", "example": "系统通知" }, "type": { "description": "类型", "type": "string", "example": "system" }, "user_id": { "description": "用户ID", "type": "string", "example": "usr_abc123" } } }, "gitee_com_autional_service-notification_internal_handler_dto.NotificationStatsDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.NotificationStatsResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.NotificationStatsResponse": { "description": "通知发送与阅读统计（notification 层不追踪投递状态，仅追踪已读/未读）", "type": "object", "properties": { "by_type": { "description": "按类型", "type": "object", "additionalProperties": { "type": "integer" } }, "read_rate": { "description": "阅读率", "type": "number", "example": 0.45 }, "total_read": { "description": "总阅读", "type": "integer", "example": 450 }, "total_sent": { "description": "总发送", "type": "integer", "example": 1000 } } }, "gitee_com_autional_service-notification_internal_handler_dto.PushSendDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.PushSendResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.PushSendResponse": { "type": "object", "properties": { "failed": { "type": "integer", "example": 0 }, "sent": { "type": "integer", "example": 3 }, "total": { "type": "integer", "example": 3 } } }, "gitee_com_autional_service-notification_internal_handler_dto.PushSubscriptionDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.PushSubscriptionResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.PushSubscriptionKeys": { "type": "object", "required": [ "auth", "p256dh" ], "properties": { "auth": { "type": "string", "example": "xK2s9..." }, "p256dh": { "type": "string", "example": "BP7S2s9..." } } }, "gitee_com_autional_service-notification_internal_handler_dto.PushSubscriptionListResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "items": { "description": "统一使用 items", "type": "array", "items": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.PushSubscriptionResponse" } }, "message": { "type": "string" }, "pagination": { "description": "分页信息（嵌套对象）", "allOf": [ { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.PageInfo" } ] }, "timestamp": { "type": "string" }, "total": { "description": "总条数（平铺，便于直接读取）", "type": "integer" } } }, "gitee_com_autional_service-notification_internal_handler_dto.PushSubscriptionRequest": { "type": "object", "required": [ "endpoint", "keys" ], "properties": { "device_name": { "type": "string", "example": "Chrome on Windows" }, "device_type": { "type": "string", "example": "web" }, "endpoint": { "type": "string", "example": "https://fcm.googleapis.com/fcm/send/..." }, "keys": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.PushSubscriptionKeys" }, "user_agent": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.PushSubscriptionResponse": { "type": "object", "properties": { "created_at": { "type": "string", "example": "2026-05-12T12:00:00Z" }, "device_name": { "type": "string", "example": "Chrome on Windows" }, "device_type": { "type": "string", "example": "web" }, "endpoint": { "type": "string", "example": "https://fcm.googleapis.com/fcm/send/..." }, "id": { "type": "string", "example": "sub-abc123" } } }, "gitee_com_autional_service-notification_internal_handler_dto.ReadReportDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.ReadReportResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.ReadReportResponse": { "description": "通知已读/未读统计报告", "type": "object", "properties": { "read_count": { "description": "已读", "type": "integer", "example": 450 }, "read_rate": { "description": "阅读率", "type": "number", "example": 0.45 }, "tenant_id": { "description": "租户ID", "type": "string", "example": "tenant-001" }, "total_sent": { "description": "总发送", "type": "integer", "example": 1000 }, "unread_count": { "description": "未读", "type": "integer", "example": 550 } } }, "gitee_com_autional_service-notification_internal_handler_dto.SecurityAdvisoryBroadcastDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.SecurityAdvisoryBroadcastResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.SecurityAdvisoryBroadcastRequest": { "type": "object", "required": [ "content", "title" ], "properties": { "content": { "type": "string", "example": "We have released a patch..." }, "title": { "type": "string", "example": "Security advisory: CVE-2026-0001" } } }, "gitee_com_autional_service-notification_internal_handler_dto.SecurityAdvisoryBroadcastResponse": { "type": "object", "properties": { "failed": { "type": "integer", "example": 0 }, "recipients": { "type": "integer", "example": 42 } } }, "gitee_com_autional_service-notification_internal_handler_dto.SecuritySubscribeDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.SecuritySubscribeResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.SecuritySubscribeRequest": { "type": "object", "required": [ "email" ], "properties": { "captcha_provider": { "type": "string" }, "captcha_token": { "type": "string" }, "company": { "type": "string", "example": "Example Inc" }, "email": { "type": "string", "example": "security@example.com" }, "topics": { "type": "array", "items": { "type": "string" }, "example": [ "[\"security_advisory\"", "\"compliance_update\"]" ] } } }, "gitee_com_autional_service-notification_internal_handler_dto.SecuritySubscribeResponse": { "type": "object", "properties": { "message": { "type": "string", "example": "确认邮件已发送" }, "status": { "type": "string", "example": "pending_confirmation" } } }, "gitee_com_autional_service-notification_internal_handler_dto.SecurityUnsubscribeDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.SecurityUnsubscribeResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.SecurityUnsubscribeRequest": { "type": "object", "required": [ "email" ], "properties": { "email": { "type": "string", "example": "security@example.com" }, "token": { "type": "string", "example": "unsub_token_abc123" } } }, "gitee_com_autional_service-notification_internal_handler_dto.SecurityUnsubscribeResponse": { "type": "object", "properties": { "message": { "type": "string", "example": "已取消订阅" }, "status": { "type": "string", "example": "unsubscribed" } } }, "gitee_com_autional_service-notification_internal_handler_dto.SendFromTemplateRequest": { "description": "使用模板发送通知请求参数", "type": "object", "required": [ "template_id", "user_id", "variables" ], "properties": { "template_id": { "description": "模板ID", "type": "string", "example": "tpl_abc123" }, "user_id": { "description": "用户ID", "type": "string", "example": "usr_abc123" }, "variables": { "description": "变量", "type": "object", "additionalProperties": true } } }, "gitee_com_autional_service-notification_internal_handler_dto.SendNotificationCompatDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.SendNotificationCompatResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.SendNotificationCompatResponse": { "description": "发送通知的响应结果（兼容端点）", "type": "object", "properties": { "id": { "description": "通知ID", "type": "string", "example": "notif-1234567890" }, "status": { "description": "状态", "type": "string", "example": "sent" } } }, "gitee_com_autional_service-notification_internal_handler_dto.SendNotificationRequest": { "description": "发送通知的请求参数", "type": "object", "required": [ "content", "title", "user_id" ], "properties": { "aggregation_key": { "description": "聚合键（同key通知聚合为一条）", "type": "string", "example": "new_follower" }, "content": { "description": "内容", "type": "string", "example": "您的账户已成功升级" }, "metadata": { "description": "元数据", "type": "object", "additionalProperties": true }, "priority": { "description": "优先级", "type": "string", "example": "medium" }, "title": { "description": "标题", "type": "string", "example": "系统通知" }, "type": { "description": "类型", "type": "string", "example": "system" }, "user_id": { "description": "用户ID", "type": "string", "example": "usr_abc123" } } }, "gitee_com_autional_service-notification_internal_handler_dto.SimpleResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.StreamTicketResponse": { "description": "一次性 SSE 票据：60s 内有效、消费一次即失效；以 ?ticket= 建立 EventSource 流", "type": "object", "properties": { "expires_in": { "description": "有效期（秒）", "type": "integer", "example": 60 }, "ticket": { "description": "一次性票据", "type": "string", "example": "1B2c3D4e5F6g7H8i9J0k1L2m3N4o5P6q7R8s9T0u1V2" } } }, "gitee_com_autional_service-notification_internal_handler_dto.TemplateDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.TemplateResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.TemplateListResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "items": { "description": "统一使用 items", "type": "array", "items": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.TemplateResponse" } }, "message": { "type": "string" }, "pagination": { "description": "分页信息（嵌套对象）", "allOf": [ { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.PageInfo" } ] }, "timestamp": { "type": "string" }, "total": { "description": "总条数（平铺，便于直接读取）", "type": "integer" } } }, "gitee_com_autional_service-notification_internal_handler_dto.TemplateResponse": { "description": "通知模板信息", "type": "object", "properties": { "content": { "description": "内容", "type": "string", "example": "亲爱的{{user_name}}，欢迎加入{{app_name}}！" }, "created_at": { "description": "创建时间", "type": "string", "example": "2026-01-01T00:00:00Z" }, "name": { "description": "模板名称", "type": "string", "example": "welcome_notification" }, "subject": { "description": "主题", "type": "string", "example": "欢迎加入{{app_name}}" }, "template_id": { "description": "模板ID", "type": "string", "example": "tpl_abc123" }, "type": { "description": "类型", "type": "string", "example": "system" }, "variables": { "description": "变量", "type": "array", "items": { "type": "string" }, "example": [ "[\"user_name\"", "\"app_name\"]" ] } } }, "gitee_com_autional_service-notification_internal_handler_dto.TestNotificationDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.TestNotificationResponse" }, "message": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.TestNotificationRequest": { "description": "发送测试通知的请求参数", "type": "object", "required": [ "channel", "target" ], "properties": { "channel": { "description": "渠道", "type": "string", "example": "email" }, "target": { "description": "目标", "type": "string", "example": "user@example.com" } } }, "gitee_com_autional_service-notification_internal_handler_dto.TestNotificationResponse": { "description": "测试通知发送结果", "type": "object", "properties": { "channel": { "description": "渠道", "type": "string", "example": "email" }, "status": { "description": "状态", "type": "string", "example": "sent" }, "target": { "description": "目标", "type": "string", "example": "user@example.com" }, "test_id": { "description": "测试ID", "type": "string", "example": "test-1234567890" } } }, "gitee_com_autional_service-notification_internal_handler_dto.TrendPoint": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-04" }, "read": { "type": "integer", "example": 30 }, "sent": { "type": "integer", "example": 45 } } }, "gitee_com_autional_service-notification_internal_handler_dto.TrendResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "items": { "description": "统一使用 items", "type": "array", "items": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.TrendPoint" } }, "message": { "type": "string" }, "pagination": { "description": "分页信息（嵌套对象）", "allOf": [ { "$ref": "#/definitions/gitee_com_autional_service-core_base_dto.PageInfo" } ] }, "timestamp": { "type": "string" }, "total": { "description": "总条数（平铺，便于直接读取）", "type": "integer" } } }, "gitee_com_autional_service-notification_internal_handler_dto.UnreadCountDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.UnreadCountResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.UnreadCountResponse": { "description": "用户未读通知数量", "type": "object", "properties": { "last_notification_at": { "description": "最后通知", "type": "string", "example": "2026-04-15T10:30:00Z" }, "unread_count": { "description": "未读数", "type": "integer", "example": 5 }, "user_id": { "description": "用户ID", "type": "string", "example": "usr_abc123" } } }, "gitee_com_autional_service-notification_internal_handler_dto.UpdateAnnouncementRequest": { "description": "更新公告的请求参数（仅在draft状态可编辑）", "type": "object", "properties": { "content": { "type": "string" }, "expire_at": { "type": "string" }, "publish_at": { "type": "string" }, "target_roles": { "type": "array", "items": { "type": "string" } }, "title": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.UpdateEventMappingRequest": { "type": "object", "properties": { "channel": { "type": "string" }, "is_enabled": { "type": "boolean" }, "priority": { "type": "string" }, "template_code": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.UpdateGlobalVariableRequest": { "type": "object", "required": [ "value" ], "properties": { "value": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.UpdateTemplateRequest": { "description": "更新通知模板的请求参数（所有字段可选）", "type": "object", "properties": { "content": { "type": "string" }, "name": { "type": "string" }, "status": { "type": "string" }, "subject": { "type": "string" }, "type": { "type": "string" }, "variables": { "type": "array", "items": { "type": "string" } } } }, "gitee_com_autional_service-notification_internal_handler_dto.VapidPublicKeyDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/gitee_com_autional_service-notification_internal_handler_dto.VapidPublicKeyResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "gitee_com_autional_service-notification_internal_handler_dto.VapidPublicKeyResponse": { "description": "Web Push VAPID 公钥，前端注册 Push 订阅时使用", "type": "object", "properties": { "public_key": { "description": "VAPID 公钥", "type": "string", "example": "BEL5Oa..." } } }, "handler.HealthErrorResponse": { "type": "object", "properties": { "error": { "type": "string" } } }, "map_string_string": { "type": "object", "additionalProperties": { "type": "string" } } }, "securityDefinitions": { "bearerAuth": { "description": "Type \"Bearer\" followed by a space and JWT token.", "type": "apiKey", "name": "Authorization", "in": "header" } }, "tags": [ { "description": "通知管理：模板、发送、投递追踪", "name": "通知服务" }, { "description": "公告管理：创建、发布、订阅", "name": "公告服务" }, { "description": "公开信任中心：安全状态、合规证书、文档", "name": "Trust Center" } ], "host": "api.autional.cn", "schemes": [ "https" ] }