fastapi-async-api

name	fastapi-async-api
description	Design FastAPI services with explicit request and response contracts, async handlers, and clean analytical API boundaries.
license	MIT
compatibility	opencode
metadata	{"audience":"backend-engineers","domain":"fastapi"}

What I do

• Define HTTP endpoints and payload schemas for analytics products.
• Keep async route handlers thin and validation-focused.
• Separate routers, services, and data-access responsibilities.
• Clarify pagination, filtering, sorting, and freshness semantics.

Default contract areas

• summary metrics endpoint
• timeseries endpoint
• breakdown endpoint
• detailed records endpoint
• health and freshness endpoint

Guardrails

• Do not leak raw warehouse complexity directly into public API contracts.
• Prefer explicit response models over loosely shaped dictionaries.