Skip to content

meta

meta endpoints — health, config, OAuth metadata, robots, sitemap.

health() -> dict[str, str]

health check endpoint.

get_public_config() -> dict[str, int | str | list[str]]

expose public configuration to frontend.

client_metadata() -> dict[str, Any]

serve OAuth client metadata.

returns metadata for public or confidential client depending on whether OAUTH_JWK is configured.

jwks_endpoint() -> dict[str, Any]

serve public JWKS for confidential client authentication.

returns 404 if confidential client is not configured.

robots_txt()

serve robots.txt to tell crawlers this is an API, not a website.

sitemap_data(db: Annotated[AsyncSession, Depends(get_db)]) -> dict[str, Any]

return minimal data needed to generate sitemap.xml.

returns tracks, artists, and albums with just IDs/slugs and timestamps. the frontend renders this into XML at /sitemap.xml.