响应包含的内容
通过 BrasilAPI 查询某一年的节假日，并在创建日历前核对 date、name、type 和 weekday。
2026 年的响应包含 date、name、type 和 weekday。全国性记录不能确认某个城市中商店、雇主、学校、公共机构或服务的营业时间。
值得查看的字段
- 日期
- 节假日名称
- 类型
- 星期
BrasilAPI Feriados
通过 BrasilAPI 查询某一年的节假日，并在创建日历前核对 date、name、type 和 weekday。
当前公开响应
加载 2026 年的节假日列表。
所查询年份的列表
该路由在 URL 中接收年份，并返回来源为该期间列出的节假日。例如，2026 年的响应包含 Tiradentes、劳动节、巴西独立日和圣诞节。更换年份是查询的一部分，因此不应把某一年的列表当成永久日历。
- 用日历实际需要显示的年份构建 URL。
- 保存日期时同时保存返回的年份，而不是只保存日和月。
- 每年开始规划时重新请求列表。
如何阅读返回字段
观察到的每一项都包含 date、name、type 和 weekday。date 是数字格式的日期；name 是来源使用的名称；type 对项目进行分类；weekday 给出葡萄牙语的星期。它们用于展示和整理响应，并不会补充响应中没有的事实。
- 使用 date 排序日程或在界面中创建本地日期。
- 将 name 作为项目标签显示，并保留返回的措辞。
- 把 type 和 weekday 作为原始返回字段，并为将来的格式变化留出空间。
适用的场景
该列表可在日程中标注日期、支持内部期限规划、准备季节性内容，或提醒团队核对临近节假日。如果最终决定考虑到地点和活动，它也可以作为旅行和沟通日历的起点。
- 标记日期时不要假定所有服务都会停业。
- 与各项业务负责人复核服务和配送期限。
- 在应用中明确显示已加载的年份和更新日期。
做决定前的边界
响应中出现某项并不能证明商店、学校、机构或交通服务会关闭。州和市的节假日、可选休假、工作轮班和内部规则都可能改变某日期的实际影响。重要安排应直接向有关组织或目的地确认。
- 不要仅从 type 推断营业时间。
- 当活动取决于城市或州时，请查阅当地来源。
- 对不能出错的旅行、服务、付款或期限保留人工确认。
