# Verzionovanie a zastaranosť

> Ako sa menia rozhrania FHIR R4 a REST v1, payloady webhookov a SDK, a ako sú oznamované zásadné zmeny.

Source: https://developers.anpheros.com/sk/guides/versioning

- **FHIR R4** na `/fhir/R4` a **REST v1** na `/v1` sú stabilné rozhrania. Aditívne zmeny (nové polia, nové typy zdrojov, nové koncové body, nové typy udalostí) sa dodávajú bez predchádzajúceho upozornenia; SDK a `docs/openapi.json` sa pregenerujú v rovnakom commite, inak test zlyhá.
- **Zásadné zmeny** dostanú nový prefix (`/v2`) a minimálne **6 mesiacov** paralelnej prevádzky; starý prefix počas tohto obdobia odpovedá hlavičkou `Deprecation` a `Sunset`.
- **Payloady webhookov** nesú `type`; nové typy sú aditívne. Predplatiteľ `*` musí ignorovať neznáme typy.
- **SDK** sa riadia semverom; hlavná verzia SDK môže odstrániť zastaraný prefix API.
- **Bezpečnostné opravy** môžu sprísniť validáciu (napríklad hodnotové sady) bez zvýšenia verzie; takéto sprísnenie sa oznamuje v changelogu s 30-dňovým predstihom, pokiaľ neuzatvára aktívnu zraniteľnosť.

## Zoznam zmien

### 14. októbra 2026 (prídavné: branding stránky súhlasu, jednotné prihlásenie tímu)

- Jednotné prihlásenie tímu: organizácia môže byť prepojená s jej SAML alebo OIDC poskytovateľom a jej e-mailovými doménami
  (`PUT /admin/organizations/{id}/sso`, administrátori platformy) a jednotné prihlásenie môže byť vyžadované pre
  členov. `GET /admin/sso/discover?email=` (bez autentifikácie) vráti poskytovateľa pre pracovný e-mail. `OrganizationOut`
  získava `sso_provider_id`, `sso_domains` a `sso_required`. Pozrite si [Jednotné prihlásenie pre váš tím](https://developers.anpheros.com/sk/guides/team-sso).

- `PUT /admin/applications/{id}/branding` nastavuje logo aplikácie (dátový URI vo formáte PNG/JPEG/WebP, do 64 KB) a
  akcentovú farbu (kontrast minimálne 4,5:1 s bielym textom), zobrazenú na hostovanej stránke súhlasu. `ApplicationOut`
  získava `logo` a `brand_color`. Pozrite si [Autentifikácia a OAuth](auth-and-oauth.md#your-brand-on-the-consent-page).
- Stránka s cenami a [ceny](https://developers.anpheros.com/sk/guides/pricing): poznámka o súkromnej beta verzii. Produkcia sa spustí po overení a podpísaní
  DPA, plány sú fakturované e-mailom a povolenia zatiaľ nie sú automaticky vynucované.

### 14. októbra 2026 (opravy tvaru chýb a mapovania laboratórnych výsledkov)
- Import laboratórnych výsledkov: *Uree* / *Urea* sa mapuje na urea (`3091-6`; `22664-7` v mmol/L) namiesto urea dusíka (`3094-0`), ktorý
  je zachovaný pre *BUN* / *Urea nitrogen* (`14937-7` v mmol/L). Hodnoty sa nekonvertujú. Žiadne produkčné dáta nepoužili staré mapovanie.
- Import laboratórnych výsledkov: LDL s metódou na správe sa mapuje na vypočítané LDL (`13457-7`) alebo priame LDL (`18262-6`); bez metódy zostáva `2089-1`. *Direct* je teraz kvalifikátor, takže *Bilirubina directa* sa už nemapuje na celkový bilirubín
  (`1975-2`); zachováva si kód laboratória. Žiadne produkčné dáta nepoužili staré mapovanie.
- Neznáme koncové body a metódy pod `/v1` odpovedajú v zdokumentovanom tvare chyby (`404 not-found`, `405 not-supported`)
  namiesto `{"detail": "Not Found"}`; neplatné parametre dopytu a limit rýchlosti na IP pod `/v1` používajú
  `{"error": …}` namiesto `OperationOutcome` (nezmenené pod `/fhir/R4`); neočakávaný `500` pod `/v1` nesie
  `error.type = "exception"` (niesol `error.code`).
- Import laboratórnych výsledkov: výsledky HL7 v2 s lokálnym alebo ne-LOINC kódovacím systémom si zachovávajú kód laboratória pod `urn:anpheros:lab-code`
  (predtým `urn:hl7:<system>`, napríklad `urn:hl7:l`). Už uložené výsledky sa nemenia.
- Import laboratórnych výsledkov: anglické názvy a synonymá LOINC sú rozpoznané (*Hemoglobin A1c*, *Glycated hemoglobin*, *HDL cholesterol*,
  *LDL cholesterol*, *Haemoglobin*); holé *Glucose* sa mapuje na sérum alebo plazmu (2345-7) ako *Glicemie*. Názvy s kvalifikátorom, ktorý koncept nemá (*urine*, *non-HDL*…), sa už nezhodujú s príbuzným testom: pred touto zmenou
  *HDL cholesterol* a *LDL cholesterol* odoslané bez LOINC kódu boli uložené ako celkový cholesterol (2093-3).
- Import laboratórnych výsledkov: opätovné odoslanie správy už nedubluje výsledky, keď sa zmení mapovanie LOINC. Nové výsledky nesú druhý identifikátor, `urn:anpheros:lab-import:v2`, zostavený zo správy (ID správy, názov a kód na správe,
  dátum, hodnota, jednotka); existujúce identifikátory zostávajú nezmenené a skoršie výsledky sú rozpoznané podľa názvu, dátumu, hodnoty, jednotky
  a ID správy. Dva výsledky s rôznymi názvami na správe, ale rovnakým LOINC kódom, dátumom a hodnotou (napríklad *Glucose* a *Glicemie*) sa už nebudú spájať do jedného.

### 13. októbra 2026 (prídavné, bez zmeny zmluvy)
- Súhlas je vynucovaný na každom odvodenom pohľade (`/v1/context`, `/v1/patients/{id}/timeline`, portál, `$everything`) s jedným
  spoločným pravidlom; požadovaná, ale nepokrytá sekcia sa zobrazí v kontexte `omitted`.
- OpenAPI teraz deklaruje `servers`, `securitySchemes` (`bearer`, `apiKey`, `oauth2`, `firebase`), per-operation `security`
  a schému odpovede pre každú operáciu; generované klienti získajú typované odpovede.
- Každý `401` nesie `WWW-Authenticate: Bearer`.
- CapabilityStatement inzeruje SMART (rozšírenie `oauth-uris`, služba `SMART-on-FHIR`) a implementačnú príručku IPS.
- Presmerovania za proxy si zachovávajú `https://`.
- `python-multipart` 0.0.20 → 0.0.32; `pip-audit` blokuje zostavenie pri známych zraniteľnostiach.
- URL webhookov musia byť verejné HTTPS: localhost (predtým akceptované v sandboxe, ale nikdy nedoručené), súkromné a rezervované adresy a názvy, ktoré na ne odkazujú, sú odmietnuté pri registrácii s 400 na `url`; doručenia sa pripájajú iba k IP adresám, ktoré práve skontrolovali (DNS rebinding).

## Vynucovanie súladu (oznámené 23. septembra 2026)

Zápisy, ktorým chýbajú požiadavky na laboratórne dáta IPS / HL7 Europe, momentálne vracajú `201`/`200` s hlavičkou `Anpheros-Conformance`. Po pozorovacom období (plánované: 60–90 dní od tohto oznámenia) platforma prejde do režimu **blokovania**: takéto zápisy budú odpovedať `422` s `OperationOutcome` uvádzajúcim každú chýbajúcu položku. Integrátori, ktorí potrebujú viac času, môžu byť počas prechodu oslobodení na základe projektu. Typy zdrojov pridané 23. septembra 2026: `Procedure`, `DiagnosticReport`, `CarePlan`, `FamilyMemberHistory`, `ServiceRequest`, `Goal` (aditívne).