Wildfire REST API

A REST API for California wildfire data built with FastAPI.

Stack

• FastAPI — modern Python REST framework with automatic Swagger docs
• Uvicorn — ASGI server

Endpoints

Method	Path	Description
GET	/fires	List all fires (supports ?county= and ?min_acres= filters)
GET	/fires/{id}	Get a single fire by ID
GET	/fires/{id}/risk	Get risk score for a fire

Run locally

pip install fastapi uvicorn --break-system-packages
uvicorn main:app --reload --port 8092

Open http://localhost:8092/docs for interactive Swagger documentation.

Key concepts demonstrated

• REST resource design (nouns not verbs)
• HTTP status codes (200, 404)
• Query parameter filtering
• Sub-resources (/fires/{id}/risk)
• Auto-generated OpenAPI documentation