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

Versionierung und veraltete Schnittstellen

Wie sich die FHIR R4- und REST v1-Schnittstellen, Webhook-Payloads und SDKs ändern und wie Breaking Changes angekündigt werden.

• FHIR R4 unter /fhir/R4 und REST v1 unter /v1 sind stabile Schnittstellen. Additive Änderungen (neue Felder, neue Ressourcentypen, neue Endpunkte, neue Ereignistypen) werden ohne Vorankündigung veröffentlicht; die SDKs und docs/openapi.json werden im selben Commit neu generiert, andernfalls schlägt ein Test fehl.
• Breaking Changes erhalten ein neues Präfix (/v2) und mindestens 6 Monate parallelen Betrieb; das alte Präfix antwortet während dieser Zeit mit einem Deprecation- und Sunset-Header.
• Webhook-Payloads tragen eine type; neue Typen sind additiv. Ein Abonnent von * muss unbekannte Typen ignorieren.
• SDKs folgen Semver; eine Hauptversion eines SDKs kann ein veraltetes API-Präfix entfernen.
• Sicherheitsfixes können die Validierung verschärfen (z. B. Wertesätze) ohne Versionsänderung; eine solche Verschärfung wird im Changelog mit 30 Tagen Vorankündigung bekannt gegeben, es sei denn, sie schließt eine aktive Schwachstelle.

Changelog

14. Oktober 2026 (additiv: Branding der Zustimmungsseite, Single Sign-On für Teams)

• Single Sign-On für Teams: Eine Organisation kann mit ihrem SAML- oder OIDC-Provider und ihren E-Mail-Domänen (PUT /admin/organizations/{id}/sso, Plattformadministratoren) verknüpft werden, und Single Sign-On kann für Mitglieder erforderlich sein. GET /admin/sso/discover?email= (keine Authentifizierung) gibt den Provider für eine geschäftliche E-Mail zurück. OrganizationOut erhält sso_provider_id, sso_domains und sso_required. Siehe Single Sign-On für Ihr Team.

• PUT /admin/applications/{id}/branding legt das Logo einer Anwendung (PNG/JPEG/WebP Data URI, bis zu 64 KB) und die Akzentfarbe (Kontrast mindestens 4,5:1 zu weißem Text) fest, die auf der gehosteten Zustimmungsseite angezeigt werden. ApplicationOut erhält logo und brand_color. Siehe Authentifizierung und OAuth.

• Preisseite und Preise: ein Hinweis auf die private Beta. Die Produktion wird nach Verifizierung und einem unterzeichneten DPA eröffnet, Pläne werden per E-Mail in Rechnung gestellt und Freibeträge werden noch nicht automatisch durchgesetzt.

14. Oktober 2026 (Korrekturen an Fehlerstruktur und Labormappings)

• Laborimport: Uree / Harnstoff wird als Harnstoff (3091-6; 22664-7 in mmol/L) und nicht als Harnstoffstickstoff (3094-0) zugeordnet, welcher für BUN / Harnstoffstickstoff (14937-7 in mmol/L) beibehalten wird. Werte werden nicht konvertiert. Keine Produktionsdaten nutzten das alte Mapping.
• Laborimport: LDL mit einer Methode auf dem Bericht wird als berechnetes LDL (13457-7) oder direktes LDL (18262-6) zugeordnet; ohne Methode bleibt es 2089-1. Direkt ist jetzt ein Qualifikator, daher wird Bilirubina directa nicht mehr dem Gesamtbilirubin (1975-2) zugeordnet; es behält den Code des Labors. Keine Produktionsdaten nutzten das alte Mapping.
• Unbekannte Endpunkte und Methoden unter /v1 antworten in der dokumentierten Fehlerstruktur (404 not-found, 405 not-supported) anstatt {"detail": "Not Found"}; ungültige Abfrageparameter und die Pro-IP-Ratenbegrenzung unter /v1 verwenden {"error": …} anstelle eines OperationOutcome (unverändert unter /fhir/R4); ein unerwarteter 500 unter /v1 trägt error.type = "exception" (er trug error.code).
• Laborimport: HL7 v2-Ergebnisse mit einem lokalen oder nicht-LOINC-Codierungssystem behalten den Code des Labors unter urn:anpheros:lab-code (zuvor urn:hl7:<system>, z. B. urn:hl7:l). Bereits gespeicherte Ergebnisse werden nicht geändert.
• Laborimport: Englische LOINC-Namen und Synonyme werden erkannt (Hämoglobin A1c, Glykiertes Hämoglobin, HDL-Cholesterin, LDL-Cholesterin, Hämoglobin); ein einfaches Glukose wird wie Glicemie als Serum oder Plasma (2345-7) zugeordnet. Namen mit einem Qualifikator, den das Konzept nicht hat (Urin, Non-HDL…), werden nicht mehr mit einem verwandten Test abgeglichen: Vor dieser Änderung wurden HDL-Cholesterin und LDL-Cholesterin, die ohne LOINC-Code gesendet wurden, als Gesamtcholesterin (2093-3) gespeichert.
• Laborimport: Das erneute Senden eines Berichts dupliziert keine Ergebnisse mehr, wenn sich das LOINC-Mapping ändert. Neue Ergebnisse tragen eine zweite Kennung, urn:anpheros:lab-import:v2, die aus dem Bericht (Berichts-ID, Name und Code auf dem Bericht, Datum, Wert, Einheit) erstellt wird; bestehende Kennungen bleiben unverändert und frühere Ergebnisse werden anhand von Name, Datum, Wert, Einheit und Berichts-ID erkannt. Zwei Ergebnisse mit unterschiedlichen Namen auf dem Bericht, aber demselben LOINC-Code, Datum und Wert (z. B. Glukose und Glicemie) werden nicht mehr zu einem zusammengeführt.

13. Oktober 2026 (additiv, keine Vertragsänderung)

• Die Zustimmung wird für jede abgeleitete Ansicht (/v1/context, /v1/patients/{id}/timeline, Portal, $everything) mit einer gemeinsamen Regel durchgesetzt; ein angeforderter, aber nicht abgedeckter Abschnitt erscheint im omitted des Kontexts.
• OpenAPI deklariert nun servers, securitySchemes (bearer, apiKey, oauth2, firebase), pro Operation security und ein Antwortschema für jede Operation; generierte Clients erhalten typisierte Antworten.
• Jede 401 trägt WWW-Authenticate: Bearer.
• Die CapabilityStatement wirbt für SMART (oauth-uris-Erweiterung, SMART-on-FHIR-Dienst) und den IPS-Implementierungsleitfaden.
• Weiterleitungen hinter dem Proxy behalten https://.
• python-multipart 0.0.20 → 0.0.32; pip-audit blockiert den Build bei bekannten Schwachstellen.
• Webhook-URLs müssen öffentliche HTTPS-URLs sein: localhost (zuvor im Sandbox akzeptiert, aber nie zugestellt), private und reservierte Adressen sowie Namen, die darauf auflösen, werden bei der Registrierung mit 400 unter url abgelehnt; Zustellungen verbinden sich nur mit den IP-Adressen, die sie gerade überprüft haben (DNS-Rebinding).

Konformitätsprüfung (angekündigt am 23. September 2026)

Schreibvorgänge, die die IPS / HL7 Europe Laboranforderungen nicht erfüllen, geben derzeit 201/200 mit einem Anpheros-Conformance-Header zurück. Nach einer Beobachtungsphase (geplant: 60–90 Tage ab dieser Mitteilung) schaltet die Plattform in den Blockierungsmodus: Solche Schreibvorgänge antworten mit 422 und einem OperationOutcome, das jede Lücke auflistet. Integratoren, die mehr Zeit benötigen, können während der Übergangsphase pro Projekt ausgenommen werden. Ressourcentypen, die am 23. September 2026 hinzugefügt werden: Procedure, DiagnosticReport, CarePlan, FamilyMemberHistory, ServiceRequest, Goal (additiv).

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