GET /announcements/{announcement_id}

Get detailed information of a specified announcement, including read statistics (views/dismissals). Reference: CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance.

Request Parameters

Name	In	Type	Required	Default	Example	Constraints	Description
id	path	string	Yes				Announcement ID

Responses

Status	Description	Schema
200	Announcement details	dto.AnnouncementDetailResponse
400	Invalid request parameters	gitee_com_linmes_authms_base_dto.SimpleResponse
401	Unauthenticated	gitee_com_linmes_authms_base_dto.SimpleResponse
403	Insufficient permissions	gitee_com_linmes_authms_base_dto.SimpleResponse
404	Resource not found	gitee_com_linmes_authms_base_dto.SimpleResponse
500	Internal server error	gitee_com_linmes_authms_base_dto.SimpleResponse

Referenced Schemas

dto.AnnouncementDetailResponse

Field	Type	Required	Example	Constraints	Description
code	integer	No
data	dto.AnnouncementResponse	No
message	string	No
timestamp	string	No

dto.AnnouncementResponse

Announcement info response

Field	Type	Required	Example	Constraints	Description
content	string	No	The system will undergo upgrade maintenance on 2026-05-15
created_at	string	No	2026-05-09T12:00:00Z
dismissals	integer	No	5
expire_at	string	No	2026-05-20T12:00:00Z
id	string	No	ann_abc123
publish_at	string	No	2026-05-10T12:00:00Z
status	string	No	published
target_roles	array of string	No
tenant_id	string	No	tnt_xyz789
title	string	No	System upgrade announcement
updated_at	string	No	2026-05-09T12:00:00Z
views	integer	No	100

gitee_com_linmes_authms_base_dto.SimpleResponse

Field	Type	Required	Example	Constraints	Description
code	integer	No
message	string	No
timestamp	string	No