API bazy leków: interakcje i relacje lek–choroba
Lekoskop udostępnia przez API ustrukturyzowaną bazę leków dostępnych w Polsce. Obejmuje interakcje lek–lek, przeciwwskazania i ostrzeżenia w chorobach współistniejących, dawkowanie w niewydolności nerek i wątroby, ciążę, karmienie piersią i grupy wiekowe. Wszystko pochodzi z Charakterystyk Produktów Leczniczych, a przy każdym fakcie jest dosłowny cytat.
Zasób danych
Co zwraca API
Interakcje lek–lek
Pary leków i klasy (np. silne inhibitory CYP3A4) z punktów 4.5 i 4.3 ChPL: opis mechanizmu, istotność według źródła i cytat.
Relacje lek–choroba
Przeciwwskazania i ostrzeżenia z punktów 4.3 i 4.4, przypisane do jednostek chorobowych ze słownika. Tam, gdzie jest dostępny, z kodem ICD-10.
Grupy szczególne
Niewydolność nerek i wątroby, ciąża, karmienie piersią, dzieci i osoby starsze — z punktów 4.2 i 4.6.
Wskazania i działania niepożądane
Wskazania z punktu 4.1 i działania niepożądane z punktu 4.8, z częstością według ChPL.
Dublowanie terapii
Ta sama substancja w kilku preparatach, także w lekach złożonych, oraz leki z tej samej podgrupy ATC.
Identyfikacja produktu
EAN/GTIN, kod GS1 DataMatrix, identyfikator z Rejestru Produktów Leczniczych, ATC, substancja, postać i moc.
Refundacja
Cena urzędowa, limit finansowania i poziom odpłatności z wykazu refundacyjnego MZ, wyszukiwane po kodzie opakowania.
Zdarzenia rynkowe
Wycofania, wstrzymania serii i nowe rejestracje z URPL i GIF, z datą i źródłem.
Przykładowe zastosowania
- Oprogramowanie gabinetowe i EDM: leki pacjenta zestawione z ChPL w chwili wystawiania recepty.
- Systemy apteczne: przegląd lekowy i opieka farmaceutyczna, sprawdzenie leków bez recepty wobec terapii stałej.
- Szpitale (HIS): uzgadnianie farmakoterapii przy przyjęciu i wypisie.
- Telemedycyna i sieci przychodni: jedno źródło danych o lekach we wszystkich placówkach.
- Badania i analityka: ustrukturyzowane dane z ChPL zamiast ręcznego czytania dokumentów.
Przykładowe zapytanie
Ilustracja formatu (REST/JSON). Pełną dokumentację przekazujemy w ramach dostępu pilotażowego.
POST /v1/check
{ "drugs": ["<GTIN leku A>", "<GTIN leku B>"], "conditions": ["N18"] }
{
"ddi": [{
"drugs": ["…", "…"],
"severity_source": "…",
"chpl_section": "4.5",
"quote": "…dosłowny fragment ChPL…"
}],
"condition_interactions": [{
"drug": "…", "condition": "Przewlekła choroba nerek", "icd10": "N18",
"chpl_section": "4.2", "quote": "…"
}],
"duplicates": [],
"refund": [{ "gtin": "…", "official_price": "…", "patient_payment": "…" }]
}
Integracja
| Format | REST, JSON, UTF-8 |
|---|---|
| Identyfikatory | EAN/GTIN, ID z Rejestru Produktów Leczniczych, ATC, ICD-10 (słownik chorób) |
| Uwierzytelnianie | Osobny klucz API dla każdego systemu |
| Dane pacjenta | Niepotrzebne. Zapytanie zawiera tylko kody leków i chorób, bez danych osobowych. |
| Aktualizacja | Rejestr i zdarzenia rynkowe codziennie, ChPL na bieżąco, refundacja po każdym obwieszczeniu MZ |
| Dostęp | Pilotaż po kontakcie: dokumentacja i klucz testowy |
Najczęstsze pytania
Dla kogo jest API Lekoskopu?
Dla dostawców oprogramowania gabinetowego i aptecznego, szpitali (HIS), sieci przychodni i aptek, telemedycyny oraz zespołów budujących narzędzia dla farmaceutów i lekarzy. Sprawdza się wszędzie tam, gdzie listę leków pacjenta trzeba zestawić z informacjami z ChPL.
Skąd pochodzą dane?
Z Charakterystyk Produktów Leczniczych z Rejestru Produktów Leczniczych (URPL) i Europejskiej Agencji Leków. Uzupełniają je wykazy refundacyjne Ministerstwa Zdrowia i komunikaty GIF. Każdy fakt kliniczny ma dosłowny cytat i numer punktu ChPL.
Czy API wydaje zalecenia kliniczne?
Nie. API zwraca informacje z ChPL w uporządkowanej postaci, z cytatem źródłowym, a nie zalecenia. Lekoskop nie jest wyrobem medycznym. Za sposób prezentacji danych użytkownikom końcowym i ewentualną kwalifikację własnego systemu jako wyrobu medycznego odpowiada integrator.
Jak identyfikować leki?
Po kodzie EAN/GTIN z opakowania (także z kodu GS1 DataMatrix), po identyfikatorze produktu z Rejestru Produktów Leczniczych, po nazwie handlowej lub substancji czynnej oraz po kodzie ATC.
Jak często dane są aktualizowane?
Rejestr i zdarzenia rynkowe (wycofania, wstrzymania serii, nowe rejestracje) codziennie. Nowe i zmienione ChPL trafiają do ekstrakcji na bieżąco, a wykaz refundacyjny jest odświeżany po każdym obwieszczeniu MZ.
Jak uzyskać dostęp?
API udostępniamy w trybie pilotażowym, po krótkiej rozmowie o zakresie integracji. Napisz przez formularz kontaktowy, a odeślemy dokumentację i klucz testowy.
Budujesz system dla przychodni, apteki lub szpitala? Opisz krótko planowaną integrację. Prześlemy dokumentację API i klucz testowy.
Zapytaj o dostęp do API