Developer Documentation

Documentation for API consumers integrating with the Legemiddelgrunndata API.

Contents

• Getting Started — Quickstart guide with curl examples to get up and running
• API Reference — Complete endpoint documentation with parameters, responses, and examples (v1 API-key and v2 HelseID endpoints)
• Authentication — How to authenticate using API keys (v1) or HelseID with DPoP (v2) and expected error responses
• Versioning and Diff — How to use version-based differential sync to fetch only changes
• Data Models — Full schema documentation for TreatmentGroup, ReimbursementGroup, and related types
• Changelog — Release notes and version history
• Working with Agents — How to set up opencode and GitHub Copilot CLI for this repository, connect them to GitLab Milliways and Azure DevOps via MCP, and add project skills
• Code Flow Through Environments — GitLab Flow branch strategy for main, test, and prod: feature promotion, patch/hotfix sync-back, and commit conventions
• System Architecture — Data flow from upstream FHIR/FEST sources through ingestion, Postgres storage, and output controllers to API consumers
• FestClient — Internal WCF client library for consuming the FEST (Statens legemiddelverk) medicinal products service
• FEST Data Model Conventions — Naming/mapping conventions for persisting FEST/M30 reference data into Fest* Postgres tables