35 lines
875 B
Python
35 lines
875 B
Python
from datetime import UTC, datetime
|
|
|
|
from app.config import settings
|
|
|
|
from .router import router
|
|
|
|
from pydantic import BaseModel
|
|
|
|
|
|
class Background(BaseModel):
|
|
"""季节背景图单项。
|
|
- url: 图片链接地址。"""
|
|
|
|
url: str
|
|
|
|
|
|
class BackgroundsResp(BaseModel):
|
|
"""季节背景图返回模型。
|
|
- ends_at: 结束时间（若为远未来表示长期有效）。
|
|
- backgrounds: 背景图列表。"""
|
|
|
|
ends_at: datetime = datetime(year=9999, month=12, day=31, tzinfo=UTC)
|
|
backgrounds: list[Background]
|
|
|
|
|
|
@router.get(
|
|
"/seasonal-backgrounds",
|
|
response_model=BackgroundsResp,
|
|
tags=["杂项"],
|
|
name="获取季节背景图列表",
|
|
description="获取当前季节背景图列表。",
|
|
)
|
|
async def get_seasonal_backgrounds():
|
|
return BackgroundsResp(backgrounds=[Background(url=url) for url in settings.seasonal_backgrounds])
|