What problem does it solve?
Implementing FHIR R4 REST APIs correctly is complex and error-prone; this Skill consolidates best practices for resource validation, correct HTTP status usage, error reporting, and authorization to reduce integration bugs and interoperability issues.
Core Features & Use Cases
- Resource Validation & Error Handling: Guidance on required fields by cardinality, enum validation, and returning OperationOutcome with appropriate HTTP status codes (422, 412, 404, etc.).
- Endpoint and Bundle Semantics: Patterns for CRUD endpoints, bundle transaction vs batch handling, pagination, and search result Bundles.
- SMART on FHIR & Security: Support for SMART on FHIR scope syntax, discovery endpoints, token exchange examples, and middleware patterns for enforcing scopes.
- Developer Tooling: Pydantic v2 model patterns, FastAPI/Express examples, and a scaffold script to create a working FHIR project for testing and prototyping.
Quick Start
Scaffold a new FHIR API project named my_fhir_api using the provided setup_fhir_project.py scaffold script.