Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

Verzionovanie a zastaranie

Ako sa menia rozhrania FHIR R4 a REST v1, dátové štruktúry webhookov a SDK, a ako sa oznamujú zásadné zmeny.

• 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.

• 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.

• Stránka s cenami a ceny: 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).

Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card