Entegrasyon ve güvenlik

Mevcut sistemlerinize bağlanır, verinizi içeride tutar.

aiMED'in REST API'si her kurumun kendi adresindedir; HBYS, RIS ve sağlık bilişim çözümleri ses gönderip rapor alır. Her kurum ayrı örnek ve ayrı veritabanıyla çalışır; kurumda sunucu kurulumu gerekmez.

Entegrasyon akışı REST API Hata sözleşmesi Güvenlik mimarisi KVKK

Entegrasyon akışı

Ses gönderin, imzalı raporu alın.

Tipik HBYS/RIS entegrasyonu dört çağrıdan oluşur. İş eşzamansız yürür; durum sorgulanır veya tamamlanınca sonuç çekilir.

Ses dosyasını gönderin

Tetkik için kaydedilen ses, hekim bilgisi ve kurumunuzun kendi referans numarasıyla gönderilir. Yanıt anında döner; iş kuyruğa alınır.

POST /api/v1/reports

Durumu izleyin

İşin adımı ve ilerleme yüzdesi sorgulanır: transkripsiyon, hasta çıkarımı, rapor üretimi, tamamlandı.

GET /api/v1/reports/{id}

Sonucu ve dosyayı alın

Hasta başına rapor HTML ve düz metin, transkript; istenirse Word, ZIP veya transkript dosyası. Dış referansınızla eşleyip HBYS'ye yazın.

GET /api/v1/reports/{id}/result

HBYS / RIS

Tetkik tamamlandı
Ses dosyası + hekim + referans

→

aiMED (kurumun örneği)

Anahtar doğrulama, IP ve hız kontrolü
Transkripsiyon · çıkarım · şablon · taslak
Doğrulama paneli ve hekim onayı
İmzalı PDF, QR doğrulama kodu

→

Geri dönüş

Rapor HTML + metin + transkript
Word / ZIP dosyası
Kurum referansıyla eşleme

REST API v1

Küçük, öngörülebilir bir yüzey.

Her kurumun API adresi kendi uygulamasındadır: https://<kurum-adresi>/api/v1. Etkileşimli doküman aynı adreste /docs altında. Kimlik doğrulama API anahtarıyla, Authorization: Bearer imk_… başlığında.

Uç nokta	İşlev	Not
`POST /reports`	Ses gönder, iş başlat	çok parçalı form: `file`, `doctor_email` veya `doctor_name`, `external_ref` → 202 ve iş kimliği
`GET /reports`	İş listesi	sayfalı; durum ve tarih filtreleri
`GET /reports/{id}`	Durum ve ilerleme	adım adı, yüzde, hata metni
`GET /reports/{id}/result`	Sonuç	hasta başına rapor HTML + metin, transkript
`GET /reports/{id}/download`	Dosya	`format=docx \| zip \| transcript`
`GET /me`	Anahtar bilgisi	ad, sınırlar, kalan kota
`GET /health`	Servis durumu	izleme sistemleri için
`GET /api` · `GET /api/v1`	Kök adresler	servis tanımı ve uç listesi; anahtar gerekmez

Örnek: ses gönderme

# Tetkik sesini gönder; 202 döner, iş kuyruğa alınır
curl -X POST https://radyoloji.kurum.gov.tr/api/v1/reports \
  -H "Authorization: Bearer imk_…" \
  -F file=@tetkik_20261025.m4a \
  -F doctor_email=dr.yilmaz@kurum.gov.tr \
  -F external_ref=RIS-2026-004812

# yanıt
{ "id": 1842, "status": "queued", "external_ref": "RIS-2026-004812" }

Örnek: sonucu alma

curl https://radyoloji.kurum.gov.tr/api/v1/reports/1842/result \
  -H "Authorization: Bearer imk_…"

{
  "id": 1842, "status": "completed", "external_ref": "RIS-2026-004812",
  "patients": [
    { "name": "Mehmet YILMAZ", "exam": "Beyin MR",
      "report_html": "…", "report_text": "…",
      "verify_code": "7K2M-…" }
  ],
  "transcript": "…"
}

Anahtar yaşam döngüsü

Anahtar kurumunuz için oluşturulur ve yalnızca o anda, bir kez gösterilir; sistemde yalnızca özeti saklanır. Döndürme, pasifleştirme ve iptal tek tıkla.

Sınırlar anahtar bazında

Dakikalık istek sınırı, azami dosya boyutu ve izinli IP/CIDR listesi her anahtar için ayrı tanımlanır. Varsayılan sınırlar kurum sözleşmenize göre belirlenir.

Her çağrı kayıt altında

Geçersiz anahtarla yapılan denemeler dâhil tüm çağrılar yazılır; çağrı, hata ve rapor sayıları kurum bazında panelde izlenir, eşik aşımında uyarı üretilir.

Hata sözleşmesi

Her hata JSON, her kod belgeli.

API altındaki tüm hatalar aynı biçimde döner: {"error", "code", "status"}. HTML hata sayfası asla dönmez.

Durum	Kod	Anlamı
401	`unauthorized`	Anahtar yok, geçersiz, pasif ya da IP izinli listede değil
404	`not_found`	İş ya da uç nokta bulunamadı
405	`method_not_allowed`	Yöntem desteklenmiyor; `Allow` başlığı izinli yöntemleri listeler
409	`conflict`	İş henüz tamamlanmadı ya da durum bu işleme uygun değil
413	`too_large`	Dosya anahtarın boyut sınırını aşıyor
422	`validation`	Eksik ya da geçersiz alan; mesaj hangi alan olduğunu söyler
429	`rate_limited`	Dakikalık sınır aşıldı; `Retry-After` başlığı bekleme süresini verir

Güvenlik mimarisi

Kurum başına izole, şifreli, izlenebilir.

Ayrı örnek, ayrı veri

Her kurum kendi uygulama örneğinde, kendi veritabanı ve dosya alanında (ses, raporlar, yüklemeler, günlükler) ve kendi oturumuyla çalışır. Kurumlar arası veri erişimi mimari olarak mümkün değildir.

Şifreli iletişim, dış bağımlılık yok

Tüm trafik TLS ile şifrelidir. Fontlar, ikonlar ve kütüphaneler uygulamanın kendi içinden sunulur; tarayıcı üçüncü taraf servislere istek atmaz, izleme betiği yoktur.

Kurum bazında yapay zekâ anahtarları

Transkripsiyon ve taslak üretimi için sağlayıcı anahtarları kurum bazında tanımlanır; kurum isterse kendi anahtarlarını kullanır. Anahtar geçersiz hale gelirse işler kuyruğa alınır ve aiMED destek ekibi uyarılır; kayıt kaybolmaz.

Roller ve ayrık giriş akışları

Sekreter, yönetici ve hekim rolleri; hekim dikte cihazı web girişinden tamamen ayrı. Yönetim sayfaları yalnızca kurum yöneticisine görünür.

Denetim kayıtları

Görüntüleme, düzenleme, indirme, paylaşım ve yönetim işlemleri kullanıcı ve zaman bilgisiyle kaydedilir; aiMED tarafındaki operasyon işlemleri de ayrıca denetlenir.

Doğrulanabilir imza

Kesinleştirilen rapor benzersiz doğrulama koduyla imzalanır; QR kod kurumun doğrulama sayfasına götürür. Model önerisi onaysız imzalı rapora giremez.

KVKK

Kişisel sağlık verisi için tasarlandı.

aiMED, özel nitelikli kişisel veri işleyen kurumların gereksinimlerini mimariye gömer: veri kurumda kalır, paylaşım açık onaya bağlıdır, her erişim izlenir.

Rapor paylaşımında açık KVKK onayı; onay metni ve zamanı kaydedilir
Veri minimizasyonu: dış sağlayıcıya yalnızca işleme için gereken içerik, kurumun anahtarıyla
Yedekleme (elle ve otomatik) kurum yöneticisinin kontrolünde; geri yükleme web'den değil, sunucuda operasyonla yapılır
Kurum silinirken veri dizini yalnızca yönetilen dizin ise kaldırılır; yanlışlıkla silme korunur

Paylaşım onayı

Mehmet YILMAZ · Beyin MR raporu Dr. Ayşe Kaya ile paylaşılacak.

Bu rapor özel nitelikli kişisel sağlık verisi içerir. Paylaşım 6698 sayılı KVKK kapsamında kaydedilecek; alıcı, zaman ve onaylayan kullanıcı denetim kaydına yazılacaktır.

Paylaşımın hukuki dayanağını ve kaydını onaylıyorum.

Paylaş ve kaydetVazgeç

Entegrasyon görüşmesi

HBYS ekibinizle birlikte planlayalım.

API dokümanı, test anahtarı ve örnek istek seti ile entegrasyon bir günde kurulur.

Görüşme talep edin Özellikler