İlaç API

Türkiye'de ruhsatlı ilaçlar için JSON API

TİTCK'nın her hafta yayınladığı Ruhsatlı Beşeri Tıbbi Ürünler Listesi'ne barkod, ilaç adı, etken madde ve ATC koduyla saniyeler içinde erişin. Eczane yazılımları, sağlık uygulamaları ve hobi projeleri için.

23.000+ ürün Haftalık güncelleme Kullanma talimatı özetleri ve soru-cevap Ücretsiz, günde 1.000 istek CORS açık

1. API anahtarı alın

E-posta adresinizi yazın; anahtar anında oluşur ve yalnızca bir kez gösterilir. Aynı e-posta ile tekrar isterseniz eski anahtar iptal olur, yenisi verilir.

2. İlk isteğinizi atın

curl "https://ilacapi.mesystemconf.com/v1/barcode/8699508010752" \
  -H "x-api-key: ilac_ANAHTARINIZ"

{
  "drug": {
    "gtin": "08699508010752",
    "barcode": "8699508010752",
    "name": "ONADRON 0.75 MG TABLET, 100 TABLET",
    "activeIngredient": "dekzametazon",
    "atc": "H02AB02",
    "licenseHolder": "MENARİNİ SAĞLIK VE İLAÇ SAN. TİC. A.Ş.",
    "packageCount": 100,
    "unit": "tablet",
    "suspended": false
  }
}

Anahtarı x-api-key başlığında ya da Authorization: Bearer ilac_... olarak gönderebilirsiniz. Karekoddaki (01) alanı doğrudan barkod olarak kullanılabilir; 13 ve 14 haneli değerlerin ikisi de kabul edilir.

Uçlar

GET/v1/barcode/{barkod}

Barkod (GTIN) ile tek ürün. Bulunamazsa 404.

GET/v1/search?q=parol&limit=20&offset=0

Ürün adı ve etken maddede tam metin arama. Her kelime önek olarak eşleşir (q=parol 500), büyük/küçük harf ve Türkçe karakter duyarsızdır. En fazla limit=100.

GET/v1/ingredient/{etken madde}

Etken maddeye göre ürünler, örn. /v1/ingredient/parasetamol.

GET/v1/atc/{kod}

ATC koduyla başlayan ürünler, örn. /v1/atc/N02BE (analjezikler) veya /v1/atc/H02AB02.

GET/v1/leaflet/{barkod}

Ürünün TİTCK onaylı Kısa Ürün Bilgisi (KÜB) ve Kullanma Talimatı (KT) PDF bağlantıları, onay tarihleri ve eşleşme yöntemi (exact, prefix, ingredient). 15.800 kullanma talimatı, ürünlerin %77'si eşleşmiş durumda.

GET/v1/summary/{barkod}

Kullanma talimatının yapay zekâ özeti: usedFor, howToUse, withFood, warnings[], commonSideEffects[], storage, missedDose. İlk istekte üretilir (5-10 sn), sonra önbellekten anında gelir. İngilizce özet için ?lang=en ekleyin (varsayılan tr). Yanıtta disclaimer alanı vardır; tıbbi tavsiye değildir.

POST/v1/ask/{barkod}

Gövde: {"question": "Yemekle alabilir miyim?", "history": [{"role": "user", "text": "..."}, {"role": "model", "text": "..."}]}. Soru yalnızca ürünün onaylı kullanma talimatına dayanarak yanıtlanır; yanıt { answer, basedOnLeaflet, seeDoctor, disclaimer }. Gövdeye "lang": "en" eklenirse yanıt İngilizce gelir (varsayılan tr). Belgede olmayan konularda basedOnLeaflet: false, hekim gerektiren konularda seeDoctor: true döner. Her çağrı yapay zekâ kullanır; kotadan 1 istek düşer.

GET/v1/meta

Anahtarsız. Veri setinin liste tarihi, içe aktarma zamanı ve ürün sayısı.

POST/v1/keys

Anahtarsız. Gövde: {"email": "..."}. Yanıt: {"key": "ilac_...", "dailyLimit": 1000}.

Liste dönen uçlar { total, limit, offset, results: [...] } şeklinde sayfalanır.

Ürün alanları

Alan	Açıklama
`gtin`	14 haneli GTIN (başına sıfır eklenmiş barkod).
`barcode`	Listedeki haliyle barkod (genellikle 13 hane).
`name`	Ürün adı, ambalaj bilgisiyle birlikte, listedeki yazımıyla.
`activeIngredient`	Etken madde(ler).
`atc`	ATC kodu.
`licenseHolder`	Ruhsat sahibi firma.
`packageCount`, `unit`	Ambalaj adedi ve birimi, üründen adından türetilir: `tablet`, `capsule`, `vial`, `sachet`, `suppository`, `piece`, `ml`, `g`. Çözülemezse `null`.
`suspended`	Ruhsatı askıda ise `true`.

Limitler ve hatalar

Anahtar başına dakikada 60, günde 1.000 istek (UTC gece yarısı sıfırlanır). Kalan hak x-ratelimit-remaining başlığında.
Hatalar {"error": {"code": "...", "message": "..."}} döner: unauthorized (401), bad_request (400), not_found (404), rate_limited ve quota_exceeded (429).
Daha yüksek kota veya ticari kullanım için yazın: support@mesystemconf.com.

Veri kaynağı ve yasal

Veriler T.C. Sağlık Bakanlığı Türkiye İlaç ve Tıbbi Cihaz Kurumu'nun (TİTCK) herkese açık Ruhsatlı Beşeri Tıbbi Ürünler Listesi'nden alınır ve her hafta yenilenir. Bu servis TİTCK ile bağlantılı değildir; liste dışı bilgi (fiyat, stok, seri numarası doğrulaması) sunmaz.

Kullanma talimatları TİTCK'nın KÜB/KT listesinden alınır ve ürünlere ad benzerliğiyle eşleştirilir; eşleşme yöntemi yanıtta belirtilir. Özetler yapay zekâ ile üretilir ve belgenin yerini tutmaz. Ambalaj adedi ve birimi ürün adından otomatik çıkarılır ve hatalı olabilir. Veriler olduğu gibi sunulur; tıbbi tavsiye değildir ve klinik kararlar için tek kaynak olarak kullanılmamalıdır. Servis, kötüye kullanım halinde anahtarı iptal etme hakkını saklı tutar.

Gizlilik: yalnızca e-posta adresiniz (anahtar için) ve istek sayacı tutulur. E-posta ile pazarlama yapılmaz.