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

Sürüm Yönetimi ve Kullanımdan Kaldırma

FHIR R4 ve REST v1 arayüzleri, webhook yükleri ve SDK'lar nasıl değişir ve geriye dönük uyumsuz değişiklikler nasıl duyurulur.

• /fhir/R4'deki FHIR R4 ve /v1'deki REST v1 kararlı arayüzlerdir. Eklemeli değişiklikler (yeni alanlar, yeni kaynak türleri, yeni uç noktalar, yeni olay türleri) bildirilmeksizin yayınlanır; SDK'lar ve docs/openapi.json aynı commit'te yeniden oluşturulur ve aksi takdirde bir test başarısız olur.
• Geriye dönük uyumsuz değişiklikler yeni bir önek (/v2) alır ve en az 6 ay boyunca paralel çalışma süresi olur; eski önek bu süre boyunca Deprecation ve Sunset başlığı ile yanıt verir.
• Webhook yükleri bir type taşır; yeni türler eklemelidir. *'e abone olan bir kullanıcı bilinmeyen türleri yok saymalıdır.
• SDK'lar semver'i takip eder; büyük bir SDK sürümü kullanımdan kaldırılmış bir API önekini düşürebilir.
• Güvenlik düzeltmeleri, sürüm yükseltmesi olmaksızın doğrulamayı sıkılaştırabilir (örneğin değer kümeleri); bu tür bir sıkılaştırma, aktif bir güvenlik açığını kapatmadığı sürece 30 günlük bildirimle değişiklik günlüğünde duyurulur.

Değişiklik Günlüğü

14 Ekim 2026 (ek: onay sayfası markalaması, ekip tek oturum açma)

• Ekip tek oturum açma: bir kuruluş, SAML veya OIDC sağlayıcısı ve e-posta alanlarıyla bağlanabilir (PUT /admin/organizations/{id}/sso, platform yöneticileri) ve üyeler için tek oturum açma zorunlu tutulabilir. GET /admin/sso/discover?email= (auth yok) bir iş e-postası için sağlayıcıyı döndürür. OrganizationOut sso_provider_id, sso_domains ve sso_required kazanır. Ekibiniz için tek oturum açma bölümüne bakın.

• PUT /admin/applications/{id}/branding, barındırılan onay sayfasında gösterilen bir uygulamanın logosunu (PNG/JPEG/WebP veri URI'si, 64 KB'a kadar) ve vurgu rengini (beyaz metinle en az 4,5:1 kontrast) ayarlar. ApplicationOut logo ve brand_color kazanır. Kimlik Doğrulama ve OAuth bölümüne bakın.

• Fiyatlandırma sayfası ve fiyatlandırma: özel beta notu. Doğrulama ve imzalanmış DPA'dan sonra üretim açılır, planlar e-posta ile faturalandırılır ve ödenekler henüz otomatik olarak zorlanmaz.

14 Ekim 2026 (hata şekli ve laboratuvar eşleme düzeltmeleri)

• Laboratuvar içe aktarma: Uree / Urea, üre nitrojenine (3094-0) yerine üreye (3091-6; mmol/L cinsinden 22664-7) eşlenir, bu da BUN / Urea nitrogen (mmol/L cinsinden 14937-7) için saklanır. Değerler dönüştürülmez. Eski eşleme hiçbir üretim verisi tarafından kullanılmadı.
• Laboratuvar içe aktarma: rapordaki bir yönteme sahip LDL, hesaplanmış LDL'ye (13457-7) veya doğrudan LDL'ye (18262-6) eşlenir; yöntem yoksa 2089-1 olarak kalır. Direct artık bir niteleyicidir, bu nedenle Bilirubina directa artık toplam bilirubine (1975-2) eşlenmez; laboratuvarın kodunu saklar. Eski eşleme hiçbir üretim verisi tarafından kullanılmadı.
• /v1 altındaki bilinmeyen uç noktalar ve yöntemler, belgelenmiş hata şeklinde (404 not-found, 405 not-supported) yerine {"detail": "Not Found"} yanıt verir; geçersiz sorgu parametreleri ve /v1 altındaki IP başına hız sınırı OperationOutcome yerine {"error": …} kullanır (/fhir/R4 altında değişmeden kaldı); /v1 altındaki beklenmeyen bir 500 error.type = "exception" taşır (error.code taşıyordu).
• Laboratuvar içe aktarma: yerel veya LOINC olmayan bir kodlama sistemine sahip HL7 v2 sonuçları, laboratuvarın kodunu urn:anpheros:lab-code (önceki urn:hl7:<system>, örneğin urn:hl7:l) altında saklar. Zaten depolanan sonuçlar değiştirilmez.
• Laboratuvar içe aktarma: İngilizce LOINC adları ve takma adları tanınır (Hemoglobin A1c, Glycated hemoglobin, HDL cholesterol, LDL cholesterol, Haemoglobin); çıplak bir Glucose, Glicemie gibi serum veya plazmaya (2345-7) eşlenir. Niteleyicisi olmayan adlar (urine, non-HDL…) artık ilgili bir testle eşlenmez: bu değişiklikten önce LOINC kodu olmadan gönderilen HDL cholesterol ve LDL cholesterol, toplam kolesterol (2093-3) olarak saklanırdı.
• Laboratuvar içe aktarma: bir raporun yeniden gönderilmesi, LOINC eşlemesi değiştiğinde sonuçları artık çoğaltmaz. Yeni sonuçlar, rapordan (rapor kimliği, rapordaki ad ve kod, tarih, değer, birim) oluşturulan ikinci bir tanımlayıcı olan urn:anpheros:lab-import:v2'yi taşır; mevcut tanımlayıcılar değişmeden kalır ve önceki sonuçlar ad, tarih, değer, birim ve rapor kimliğiyle tanınır. Raporda farklı adları olan ancak aynı LOINC koduna, tarihe ve değere sahip iki sonuç (örneğin Glucose ve Glicemie) artık tek bir sonuca birleştirilmez.

13 Ekim 2026 (ek, sözleşme değişikliği yok)

• Tek paylaşılan kural ile her türetilmiş görünümde (/v1/context, /v1/patients/{id}/timeline, portal, $everything) onay zorlanır; istenen ancak kapsanmayan bir bölüm, bağlamın omitted'sinde görünür.
• OpenAPI artık servers, securitySchemes (bearer, apiKey, oauth2, firebase), işlem başına security ve her işlem için bir yanıt şeması beyan eder; oluşturulan istemciler yazılan yanıtlar alır.
• Her 401 WWW-Authenticate: Bearer taşır.
• CapabilityStatement, SMART'ı (oauth-uris uzantısı, SMART-on-FHIR hizmeti) ve IPS uygulama kılavuzunu duyurur.
• Proxy'nin arkasındaki yönlendirmeler https://'yi saklar.
• python-multipart 0.0.20 → 0.0.32; pip-audit bilinen güvenlik açıkları nedeniyle derlemeyi engeller.
• Webhook URL'leri genel HTTPS olmalıdır: localhost (daha önce sandbox'ta kabul edildi ancak asla teslim edilmedi), özel ve ayrılmış adresler ve bunlara çözümleyen adlar, url'de 400 ile kayıt sırasında reddedilir; teslimatlar yalnızca az önce kontrol ettikleri IP adreslerine bağlanır (DNS yeniden bağlama).

Uyumluluk Zorlaması (23 Eylül 2026 tarihinde duyuruldu)

IPS / HL7 Europe laboratuvar gereksinimlerini karşılamayan yazmalar şu anda 201/200 ile bir Anpheros-Conformance başlığı döndürmektedir. Bir gözlem süresinden sonra (planlanan: bu bildiriden itibaren 60-90 gün) platform engelleme moduna geçecektir: bu tür yazmalar, her bir eksikliği listeleyen bir OperationOutcome ile 422 yanıtı verecektir. Daha fazla zamana ihtiyaç duyan entegratörler, geçiş sırasında proje bazında muafiyet alabilirler. 23 Eylül 2026 tarihinde eklenen kaynak türleri: Procedure, DiagnosticReport, CarePlan, FamilyMemberHistory, ServiceRequest, Goal (eklemeli).

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