Bu API spesifikasyonları, Ulusal Dijital Sağlık Misyonu (NDHM) ağında yalnızca Sağlık Bilgi Kullanıcısı (HIU) rolünü üstlenecek sistemler için hazırlanmıştır. Spesifikasyonlar, Gateway ve Bridge'deki API'lerin bir araya getirilmiş halidir ve HIU'ların ağa katılım için hangi API'leri uygulaması gerektiğini netleştirir. API'ler akışlara göre düzenlenmiştir: kimlik doğrulama, onay akışı, veri akışı ve izleme. Çoğu API için Gateway tarafından bir çağrı başlatıldıysa, Gateway üzerinde karşılık gelen bir geri çağırma API'si bulunur. Örneğin, HIU tarafındaki /consents/hiu/notify API'si için Gateway'de /consents/hiu/on-notify geri çağrısı beklenir. HIU'ların Gateway'e çağırması gereken API'ler 'Gateway' etiketi altında gruplanmıştır. Bazı API dokümanlarında X-HIP-ID başlığı belirtilir; bu, API'nin hem HIU hem de HIP rollerine uygulanabilir olduğu durumlardır. Yalnızca HIU rolü oynanıyorsa yalnızca X-HIU-ID başlığı gönderilir.
Hangi ihtiyaçlarda değerlendirilebilir?
- Ulusal Dijital Sağlık Misyonu (NDHM) ağında HIU rolü üstlenecek sağlık kuruluşları
- Sağlık verisi paylaşımı için onay yönetimi ve veri akışı entegrasyonu geliştiren yazılım ekipleri
- Hastane bilgi sistemleri veya sağlık verisi platformları geliştiren kurumlar
Yaygın kullanım alanları
Onay Yönetimi
Hasta onaylarının alınması, yönetilmesi ve iptali için gerekli API'lerin uygulanması.
Veri Erişimi
Sağlık verilerinin HIU tarafından talep edilmesi ve alınması süreçlerinin API'lerle yönetilmesi.
İzleme ve Raporlama
Veri akışlarının izlenmesi ve sağlık verisi paylaşım süreçlerinin raporlanması.
İncelenmesi gereken noktalar
- Spesifikasyonlar, NDHM ağındaki Gateway ve Bridge yapılarına bağımlıdır; bu nedenle entegrasyon öncesinde ağ altyapısının anlaşılması gerekir.
- API'lerin bir kısmı hem HIU hem de HIP rollerini destekler; bu durumda başlık kullanımına dikkat edilmelidir.
- Sürüm 0.5'tir; API değişiklikleri ve geriye dönük uyumluluk konuları izlenmelidir.
WordPress.org
Kurulum ve geliştirme notları
Bu spesifikasyonlar bir yazılım paketi değil, API tanımlarıdır. Kurulum adımları yerine, API'lerin uygulanacağı sistemin mimarisine göre entegrasyon planlaması yapılmalıdır.
Geliştirme sürecinde, API spesifikasyonlarındaki akışlara uygun olarak uç noktaların ve geri çağırma mekanizmalarının tasarlanması gerekir. Gateway ile iletişim için güvenlik ve kimlik doğrulama yöntemleri değerlendirilmelidir.
- API'ler kimlik doğrulama, onay akışı, veri akışı ve izleme olarak dört ana akışta gruplanmıştır.
- Gateway tarafından başlatılan çağrılar için karşılık gelen geri çağırma API'lerinin uygulanması zorunludur.
- X-HIU-ID ve X-HIP-ID başlıklarının doğru kullanımı, rol bazlı erişim için kritiktir.
Hazır çözümün ötesinde
Özel geliştirme ne zaman değerlendirilebilir?
ZeplinGo olarak, NDHM HIU API spesifikasyonlarına uygun sağlık verisi paylaşım sistemlerinin tasarımı ve geliştirilmesi için kapsam belirleme çalışmaları yapıyoruz. Kurumunuzun ihtiyaçlarına göre özel entegrasyon çözümleri planlayabiliriz.
Ücretsiz ön çalışma isteyin →Değerlendirme soruları
Bu API spesifikasyonları hangi rolleri kapsar?
Bu spesifikasyonlar, NDHM ağında yalnızca HIU rolünü üstlenecek sistemler için hazırlanmıştır. Ancak bazı API'ler hem HIU hem de HIP rollerini destekler.
Gateway ile iletişim nasıl sağlanır?
HIU'lar, Gateway üzerindeki API'leri çağırarak iletişim kurar. Örneğin, onay talebi için /consent-requests/init API'si kullanılır.
X-HIU-ID ve X-HIP-ID başlıkları ne zaman kullanılır?
Yalnızca HIU rolü oynanıyorsa X-HIU-ID başlığı gönderilir. Eğer sistem hem HIU hem de HIP rolünü üstleniyorsa, ilgili API'ye göre her iki başlık da kullanılabilir.
