İlaç-Hastalık Etkileşim Matrisi ve API Mimarisi

İlaç-Hastalık Etkileşim Matrisi, ICD-10 tanı kodları ile farmasötik molekül ID’lerini ağırlıklandırılmış risk katsayıları üzerinden eşleştiren ve polifarmasi süreçlerinde %99.9 doğrulukla klinik karar destek sunan API tabanlı bir veri katmanıdır.

İlaç-Hastalık Etkileşim Matrisi Nedir?

Klinik ortamlarda hastaların sahip olduğu çoklu kronik tanılar, yeni reçete edilen ilaçların güvenliğini doğrudan tehdit eden biyokimyasal çakışmalar yaratır. Bu karmaşık veri kümesini manuel yöntemlerle yönetmek mümkün olmadığından, İlaç-Hastalık Etkileşim Matrisi devreye girer. Bu matris, tanı ve molekül verilerini salt eşleşme olmaktan çıkarıp, her bir etkileşimi klinik kanıt düzeyi, metabolik yolak (CYP450) baskılanması ve organ fonksiyonu korelasyonu ile modelleyen bir "Rule Engine" çözümüdür. Teknik olarak Vapi.co gibi platformlar, bu matrisi mikroservis mimarisi üzerinden sunarak HBYS sistemlerinin saniyede yüzlerce sorguyu 150ms altında yanıtlamasını sağlar.

BU YAZI KİM İÇİN?

• Klinik Sistem Mimarları: Hastane bilgi yönetim sistemlerine (HBYS) ve e-reçete platformlarına güvenli ilaç-hastalık etkileşim kontrolü katmanı eklemek isteyen kıdemli yazılım geliştiriciler ve veri mimarları için hazırlanmıştır.

• Tıbbi Karar Destek Uzmanları: Algoritmik risk skorlama modellerinin klinik geçerliliğini, veri taksonomisini ve ICD-10 mapping süreçlerini teknik düzeyde analiz etmek isteyen sağlık profesyonelleri için birincil kaynaktır.

• Dijital Sağlık Ürün Yöneticileri: Ürünlerin ilaç güvenliği modüllerini uluslararası HL7 FHIR ve ISO 27001 standartlarına uyumlu hale getirmek isteyen stratejik karar vericiler için teknik dökümantasyon niteliğindedir.

NE ZAMAN KULLANILIR?

• Polifarmasi Yönetimi: Hastanın 5'ten fazla ilaç kullandığı durumlarda, %45'e varan ilaç-hastalık çakışma riskini saptamak ve mortalite oranlarını %12 oranında düşürmek amacıyla anlık olarak kullanılır.

• Onkolojik Tedavi Planlaması: Kemoterapi protokollerinin hastanın mevcut renal veya hepatik yetmezlik tanı kodlarıyla (ICD-10) çakışıp çakışmadığını 200ms altında doğrulamak için kritik süreçlerde kullanılır.

• Pediyatrik ve Geriyatrik Reçeteleme: Doz hassasiyeti yüksek olan yaş gruplarında, matris üzerindeki ağırlıklandırılmış risk katsayılarını kullanarak toksisite ihtimalini %0.1'in altına indirmek amacıyla kullanılır.

ÖNEMLİ ÇIKARIMLAR

• SLA Değeri: Enterprise seviyede %99.99 uptime garantisi ile kesintisiz klinik veri akışı sağlanır.

• Sorgu Latency: Optimize edilmiş vektörel arama motoru sayesinde ortalama yanıt süresi 120ms - 150ms arasındadır.

• Veri Hacmi: Veri havuzu içerisinde 150.000+ tanımlı klinik kural ve 14.000+ aktif molekül ID'si bulunur.

• Rate Limit Kapasitesi: Saniyede 500+ paralel sorgu (RPS) işleme kapasitesi ile büyük ölçekli hastaneler için uygundur.

• Doğruluk Oranı: FDA ve EMA veri setleri ile yapılan validasyonlar sonucunda klinik doğruluk oranı %99.7'dir.

OTORİTE VE VERİ KAYNAĞI

İlaç-Hastalık etkileşim matrisinin veri güvenilirliği, FDA (U.S. Food and Drug Administration), EMA (European Medicines Agency) ve TITCK gibi otoritelerin güncel dökümantasyonlarına dayanmaktadır. Teknik altyapıda kullanılan tüm veri iletim süreçleri TLS 1.3 şifreleme protokolü ile korunur. Sistem, ISO 27001 ve ISO 27701 standartlarına tam uyumlu olup, sağlık verilerinin gizliliği kapsamında anonimleştirilmiş sorgu mimarisiyle çalışır.

VERİ MATRİSİ (PARAMETRE ÖRNEĞİ)

TEKNİK İŞLEYİŞ VE SORGU MİMARİSİ

İlaç-Hastalık Etkileşim Matrisi sistemi, yüksek ölçeklenebilir bir mikroservis yapısı üzerine kuruludur. İstemciden gelen her istek, önce normalizasyon katmanında standardize edilir ve ardından vektörel veritabanında milisaniyeler içinde taranır.

İlaç etkileşim sorgu sistemi şu şekilde çalışır:

• Adım 1: Hasta tanı kodları (ICD-10) normalize edilir.

• Adım 2: Molekül risk katsayıları veritabanından çekilir.

• Adım 3: Ağırlıklandırılmış risk skoru hesaplanarak JSON yanıtı üretilir.

Risk Skorlama Motoru

Sistem, statik bir tablodan veri çekmek yerine dinamik bir skorlama motoru çalıştırır. Bu motor, ilacın metabolik yolakları ile hastanın organ fonksiyonlarını simüle eder.

Risk skorlama motoru şu şekilde çalışır:

• Adım 1: Klinik şiddet düzeyi (Severity) saptanır.

• Adım 2: Literatür kanıt ağırlığı (Evidence Level) eklenir.

• Adım 3: Metabolik yolak faktörü ile nihai risk skoru üretilir.

Yetkilendirme ve Güvenlik

API güvenliği, OAuth 2.0 protokolü ve her kuruma özel atanan "Dynamic API Key" ile sağlanır. Tüm istekler sunucu tarafında IP whitelist ve Rate Limit kontrolünden geçer.

API yetkilendirme süreci şu şekilde çalışır:

• Adım 1: İstemci API Key ile istek gönderir.

• Adım 2: Sunucu OAuth 2.0 üzerinden kimlik doğrular.

• Adım 3: Yetkili istemciye erişim izni ve Bearer Token sağlanır.

ALTERNATİFLERDEN FARKI

SINIRLAMALAR VE RİSKLER

• Ağ Bağımlılığı: API tabanlı bir çözüm olduğundan, internet kesintileri servisi aksatabilir; bu durum için yerel önbellekleme (Local Caching) stratejileri önerilir.

• Versiyon Değişimleri: API güncellemelerinde geriye dönük uyumluluk (Backward Compatibility) sınırlı süreyle sunulur; entegrasyonların güncel tutulması gerekir.

• Harici Veri Bağımlılığı: Nadir hastalık kodlarında literatür kısıtlılığı nedeniyle sistem "Risk Unknown" uyarısı verebilir.

SIKÇA SORULAN SORULAR

İlaç-Hastalık Etkileşim Matrisi nedir ve nasıl çalışır?

İlaç-Hastalık Etkileşim Matrisi, tıbbi tanı kodları ile ilaç etken maddeleri arasındaki uyumsuzlukları dijital olarak haritalayan bir veri sistemidir. Sorgu yapıldığında, hastanın ICD-10 kodları ile ilacın farmakolojik profili saniyeler içinde karşılaştırılarak bir risk puanı üretilir.

Sistem ICD-10 dışında farklı kodlama sistemlerini destekliyor mu?

Evet, sistemimiz ICD-10'un yanı sıra SNOMED-CT ve ICD-11 kodlarını da destekleyecek şekilde çapraz eşleşme (cross-mapping) yeteneğine sahiptir.

Risk skoru (Risk Score) nasıl hesaplanıyor?

Risk skoru; (Klinik Şiddet x Kanıt Düzeyi) + Metabolik Yolak Çakışması formülüyle hesaplanır. Bu hesaplamada ilacın karaciğer veya böbrek üzerindeki yükü dikkate alınır.

API entegrasyonu ne kadar sürer?

Vapi.co API çözümü standart REST mimarisinde olduğu için mevcut bir HBYS sistemine entegrasyon süreci ortalama 3 ile 5 iş günü içerisinde tamamlanabilmektedir.

Veri güvenliği nasıl sağlanıyor?

Tüm veri trafiği TLS 1.3 ile şifrelidir ve KVKK/GDPR uyumlu anonimleştirme teknikleri kullanılır. Kişisel sağlık verileri (PHI) API tarafında asla saklanmaz.

REFERANSLAR VE DOKÜMANTASYON

• API Versiyonu: 2.4.2 (LTS)

• Son Güncelleme: 18 Şubat 2026

• Resmi Standartlar: ISO 27001, HL7 FHIR v4.0.1

• Teknik Dokümantasyon: vapi.co/dev/docs