MedlinePlus Connect: Web Hizmeti

İçerik

• Web Hizmetine Genel Bakış
• Çıkış Parametreleri
• Teşhis (Sorun) Kodları Talepleri
• Opsiyonel Parametreler
• Sorun Kodu İsteklerine Yanıt Olarak Seçilmiş Atom Öğelerinin (veya JSON nesnelerinin) Açıklaması
• Sorun Kodları için Talep Örnekleri
• İlgili Hizmetler ve Dosyalar
• İlaç Bilgisi Talepleri
• Opsiyonel Parametreler
• İlaç Taleplerine Yanıtta Seçilmiş Atom Elemanlarının (veya JSON nesnelerinin) Açıklaması
• İlaç Kodları için Talep Örnekleri
• Laboratuvar Test Bilgisi Talepleri
• Opsiyonel Parametreler
• Laboratuvar Test İsteklerine Yanıtta Seçilmiş Atom Öğelerinin (veya JSON nesnelerinin) açıklaması
• Laboratuvar Testleri Talep Örnekleri
• Kabul Edilebilir Kullanım Politikası
• Daha fazla bilgi

MedlinePlus Connect, bir Web uygulaması veya Web hizmeti olarak mevcuttur. Aşağıda, isteklere yanıt veren Web hizmetinin uygulanmasına ilişkin teknik ayrıntılar verilmiştir:

MedlinePlus Connect tarafından döndürülen verilere bağlantı verebilir ve bunları görüntüleyebilirsiniz. MedlinePlus sayfalarını sitenize kopyalayamazsınız. MedlinePlus Connect Web Hizmetinden veri kullanıyorsanız, lütfen bilgilerin MedlinePlus.gov'dan geldiğini belirtin, ancak MedlinePlus logosunu kullanmayın veya MedlinePlus'ın belirli ürününüzü desteklediğini ima etmeyin. Daha fazla rehberlik için lütfen NLM'nin API sayfasına bakın. Bu hizmetin dışında MedlinePlus içeriğine nasıl bağlantı verileceği hakkında daha fazla bilgi için lütfen bağlantı oluşturma konusundaki yönergelerimize ve talimatlarımıza bakın.

MedlinePlus Connect'i kullanmaya karar verirseniz, gelişmelerden haberdar olmak ve iş arkadaşlarınızla fikir alışverişinde bulunmak için e-posta listesine kaydolun. Lütfen bizimle iletişime geçerek MedlinePlus Connect'i uygulayıp uygulamadığınızı bize bildirin.

Web Hizmetine Genel Bakış

Web hizmeti istekleri için parametreler, HL7 Bağlama Duyarlı Bilgi Alma (Bilgi düğmesi) Bilgi Talebi URL'sine Dayalı Uygulama Kılavuzuna uygundur. REST tabanlı yanıt, HL7 Bağlama Duyarlı Bilgi Alma (Bilgi düğmesi) Hizmet Odaklı Mimari Uygulama Kılavuzuna uygundur. İsteğin çıktısı, Atom besleme biçiminde, JSON veya JSONP'de XML olabilir.

İsteğin yapısı, ne tür bir kod gönderdiğinizi gösterir. Her durumda, Web hizmetinin temel URL'si şudur: https://connect.medlineplus.gov/service

MedlinePlus Connect, HTTPS bağlantılarını kullanır. HTTP istekleri kabul edilmeyecektir ve HTTP kullanan mevcut uygulamalar HTTPS'ye güncellenmelidir.

Çıkış Parametreleri

Bu parametreler isteğe bağlıdır. Bunları dışarıda bırakırsanız, varsayılan yanıt XML biçimindeki İngilizce bilgidir.

Dil
Yanıtın İngilizce mi yoksa İspanyolca mı olmasını istediğinizi belirtin. MedlinePlus Connect, belirtilmemişse dilin İngilizce olduğunu varsayacaktır.

Sorun kodu aramasına verilen yanıtın İspanyolca olmasını istiyorsanız, şunu kullanın: informationRecipient.languageCode.c=es
(=sp da kabul edildi)

İngilizce belirtmek için aşağıdakileri kullanın: informationRecipient.languageCode.c=en

Biçim
Yanıt biçiminin XML, JSON veya JSONP olmasını isteyip istemediğinizi belirleyin. XML varsayılandır.

JSON istemek için şunu kullanın:

bilgiResponseType=uygulama/json

JSONP için şunu kullanın:

KnowledgeResponseType=application/javascript&callback=CallbackFunction burada CallbackFunction, geri arama işlevine verdiğiniz bir addır.

XML'de bir yanıt için şunu kullanın:

bilgiResponseType=text/xml veya bilgiResponseType parametresini isteğin dışında bırakın.

Teşhis (Sorun) Kodları Talepleri

Sorun kodu için MedlinePlus Connect, MedlinePlus sağlık konu sayfalarından, genetik sayfalarından veya diğer NIH Enstitülerinin sayfalarından bağlantılar ve bilgiler döndürür.

MedlinePlus Connect aşağıdakileri döndürür:

Her kod için her zaman bir eşleşme olmayabilir. Bu durumlarda MedlinePlus Connect boş bir yanıt döndürür.

Hizmetin temel URL'si: https://connect.medlineplus.gov/service

Bu hizmete yönelik herhangi bir sorgu için gerekli iki parametre vardır:

1. Kod Sistemi
   Kullanacağınız problem kodu sistemini tanımlayın.

   ICD-10-CM kullanımı için:

   mainSearchCriteria.v.cs=2.16.840.1.113883.6.90

   ICD-9-CM kullanımı için:

   mainSearchCriteria.v.cs=2.16.840.1.113883.6.103

   SNOMED CT kullanımı için:

   mainSearchCriteria.v.cs=2.16.840.1.113883.6.96

2. kod
   Aramaya çalıştığınız gerçek kodu tanımlayın:
   mainSearchCriteria.v.c=250.33

Opsiyonel Parametreler

Kod Başlığı
Ayrıca sorun kodunun adını/başlığını da belirleyebilirsiniz. Ancak bu bilgi yanıtı etkilemez (ad/başlık bilgilerinin kullanılabileceği MedlinePlus Connect Web uygulamasının aksine). mainSearchCriteria.v.dn=Diabetes mellitus ile diğer coma tip 1 kontrolsüz Dil ve çıktı biçimleriyle ilgili ayrıntılar için Çıktı Parametreleri ile ilgili yukarıdaki bölüme bakın.

Sorun Kodu İsteklerine Yanıt Olarak Seçilmiş Atom Öğelerinin (veya JSON nesnelerinin) Açıklaması

eleman	sınıf düğümü	Açıklama
Başlık		Eşleşen MedlinePlus sağlık konu sayfasının veya GHR sayfasının başlığı
bağlantı		Eşleşen MedlinePlus sağlık konu sayfası veya GHR sayfası için URL
özet		Sağlık konusunun tam özeti. Bu, diğer ilgili sağlık konularına gömülü bağlantıları ve madde işaretleri ve paragraf aralığı dahil tüm biçimlendirmeleri içerir. Özet HTML'dedir. GHR sayfaları için tam sayfanın ilk bölümü sağlanır.
özet		Konunun eş anlamlıları. Bunlara sağlık konu sayfasında "Ayrıca denir" denir. Tüm konuların "Ayrıca denir" terimleri yoktur.
özet		Özetin çoğunluğu başka bir federal kurumdan ise, özet metni için atıf onayı. Tüm özetlerin bir özelliği yoktur. İlişkilendirilmemiş metin orijinal MedlinePlus'tır.
özet		Konuyla ilgili seçilmiş bağlantılar. Buna sayfa adı, URL ve ilişkili kuruluş (varsa) dahildir. Bağlantılar madde işaretli listede biçimlendirilir. Tüm konularda bu bağlantılar yoktur. Bağlantı sayısı sıfırdan düzinelerce olabilir.

Sorun Kodları için Talep Örnekleri

İspanyolca konuşan bir hasta için diğer tip 1 kontrolsüz, ICD-9 kod 250.33 ile birlikte Diabetes Mellitus için eksiksiz bir istek, aşağıdaki URL adresine sahip olacaktır: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16 .840.1.113883.6.103&mainSearchCriteria.vc=250.33&mainSearchCriteria.v.dn=Diabetes%20mellitus%20with%20other%20coma%20type%201%20uncontrol&informationRecipient.languageCode.c=es

Aynı tanıya sahip ancak istenen format JSON ve dili İngilizce olan bir hasta: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.103&mainSearchCriteria.vc=250.33&knowledgeResponseType=application /json

SNOMED CT kodu 41381004 kullanılarak "Pseudomonas'a bağlı zatürree" teşhisi konan bir hasta: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchCriteria.v.dn= Pneumonia%20due%20to%20Pseudomonas%20%28disorder%29&informationRecipient.languageCode.c=tr

Aynı tanıya sahip ancak istenen format JSONP olan bir hasta: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.v.c=41381004&knowledgeResponseType=application/javascript&callback=CallbackFunction

İlgili Hizmetler ve Dosyalar

MedlinePlus sağlık konularını sorun kodlarının aksine metin isteklerine yanıt olarak almak için MedlinePlus Web hizmetini araştırın. Ayrıca, XML formatında MedlinePlus sağlık konularının tamamına ihtiyacınız varsa, XML dosyaları sayfamıza bakın.

İlaç Bilgisi Talepleri

MedlinePlus Connect, bir RXCUI alırken en iyi ilaç bilgisi eşleşmelerini sağlar. Ayrıca bir NDC kodu alırken iyi sonuçlar sağlar. MedlinePlus Connect, İngilizce veya İspanyolca olarak yanıt verebilir.

İngilizce ilaç bilgisi talepleri için, bir NDC veya RXCUI göndermezseniz veya koda göre herhangi bir eşleşme bulamazsak, uygulama en iyi ilaç bilgisi eşleşmesini görüntülemek için gönderdiğiniz metin dizisini kullanacaktır. İspanyolca ilaç bilgileri talepleri için MedlinePlus Connect yalnızca NDC'lere veya RXCUI'lere yanıt verir ve metin dizeleri kullanmaz. İngilizce yanıt almak mümkündür ancak İspanyolca yanıt alamamak mümkündür.

MedlinePlus Connect Web hizmeti aşağıdakileri döndürür:

Bir ilaç talebine birden fazla yanıt verilebilir. Her istek için her zaman bir eşleşme olmayabilir. Bu durumlarda MedlinePlus Connect boş bir yanıt döndürür.

İlaç bilgisi talepleri için temel URL şudur: https://connect.medlineplus.gov/service

Bir istek göndermek için şu bilgileri ekleyin:

1. Kod Sistemi
   Gönderdiğiniz ilaç kodunun türünü tanımlayın. (İngilizce ve İspanyolca için gereklidir)
   

   RXCUI kullanımı için:

   mainSearchCriteria.v.cs=2.16.840.1.113883.6.88

   NDC kullanımı için:

   mainSearchCriteria.v.cs=2.16.840.1.113883.6.69

   MedlinePlus Connect ayrıca ilaç bilgisi talepleri için İngilizce bir metin dizesini de kabul edebilir, ancak yukarıda listelenen iki kod sisteminden birini ekleyerek ilaç bilgisi aradığınızı belirtmelisiniz.
2. kod
   Aramaya çalıştığınız gerçek kodu tanımlayın. (İngilizce için tercih edilir, İspanyolca için gereklidir)
   mainSearchCriteria.v.c=637188
3. İlaç Adı
   İlacın adını bir metin dizisiyle tanımlayın. (İngilizce için isteğe bağlı, İspanyolca için kullanılmaz)
   mainSearchCriteria.v.dn=Chantix 0.5 MG Oral Tablet

En azından kod sistemini ve kodu veya kod sistemini ve ilacın adını tanımlamanız gerekir. İngilizce istekleri için en iyi sonuçları almak için üçünü de gönderin. Kod sistemini ve İspanyolca istekleri için kodu gönderin.

Opsiyonel Parametreler

Kod Başlığı

İngilizce bilgi talebi gönderirken, ilacın adının isteğe bağlı parametresini dahil edebilirsiniz. Bu, yukarıdaki bölümde ayrıntılı olarak açıklanmıştır. mainSearchCriteria.v.dn=Chantix 0.5 MG Oral Tablet

Dil ve çıktı biçimleriyle ilgili ayrıntılar için Çıktı Parametreleri ile ilgili yukarıdaki bölüme bakın.

İlaç Taleplerine Yanıtta Seçilmiş Atom Elemanlarının (veya JSON nesnelerinin) Açıklaması

eleman	Açıklama
Başlık	Eşleşen MedlinePlus ilaç sayfasının başlığı
bağlantı	Eşleşen MedlinePlus ilaç sayfasının URL'si
yazar	İlaç bilgileri için kaynak atıf

İlaç Kodları için Talep Örnekleri

İlaç bilgi talebiniz aşağıdakilerden biri gibi görünmelidir.

Bir RXCUI tarafından bilgi talep etmek için talebiniz şöyle görünmelidir: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.88&mainSearchCriteria.vc=637188&mainSearchCriteria.v.dn=Chantix% 200.5%20MG%20Oral%20Tablet&informationRecipient.languageCode.c=tr

Bir NDC tarafından İspanyolca konuşan biri için bilgi istemek için talebiniz şu şekilde görünmelidir: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=00310-0751- 39&informationRecipient.languageCode.c=es

İlaç kodu olmadan bir metin dizesi göndermek için, MedlinePlus Connect'in ilaç bilgilerini aradığınızı bilmesi için sorgunuzu NDC tipi bir istek olarak tanımlamanız gerekir. Bu, yalnızca İngilizce istekleri için çalışacaktır. İsteğiniz şöyle görünebilir: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.v.dn=Chantix%200.5%20MG%20Oral%20Tablet&informationRecipient.languageCode.c =tr

Laboratuvar Test Bilgisi Talepleri

MedlinePlus Connect, bir LOINC talebi alındığında laboratuvar test bilgileriyle eşleşmeler sağlar. Hizmet, İngilizce veya İspanyolca olarak yanıt verebilir.

MedlinePlus Connect Web hizmeti aşağıdakileri döndürür:

Her kod için her zaman bir eşleşme olmayabilir. Bu durumlarda MedlinePlus Connect boş bir yanıt döndürür.

Hizmetin temel URL'si: https://connect.medlineplus.gov/service

Bunlar, bu hizmete yönelik herhangi bir laboratuvar testi sorgusu için gerekli iki parametredir:

1. Kod Sistemi
   

   LOINC kod sistemini kullandığınızı belirleyin. Kullanım:

   mainSearchCriteria.v.cs=2.16.840.1.113883.6.1

   MedlinePlus Connect ayrıca şunları kabul eder:

   mainSearchCriteria.v.cs=2.16.840.1.113883.11.79

2. kod
   aramaya çalıştığınız gerçek kodu tanımlayın:
   mainSearchCriteria.v.c=3187-2

Opsiyonel Parametreler

Kod Başlığı

Ayrıca laboratuvar testinin adını da belirleyebilirsiniz. Ancak, bu bilgi yanıtı etkilemez. mainSearchCriteria.v.dn=Faktör IX testi

Dil ve çıktı biçimleriyle ilgili ayrıntılar için Çıktı Parametreleri ile ilgili yukarıdaki bölüme bakın.

Laboratuvar Test İsteklerine Yanıtta Seçilmiş Atom Öğelerinin (veya JSON nesnelerinin) açıklaması

eleman	Açıklama
Başlık	Eşleşen MedlinePlus laboratuvar test sayfasının başlığı
bağlantı	Eşleşen MedlinePlus laboratuvar test sayfasının URL'si
özet	Sayfa içeriğinden snippet
yazar	Laboratuar testi içeriği için kaynak ilişkilendirmesi

Laboratuvar Testleri Talep Örnekleri

İngilizce konuşan biri için bilgi istemek için talebiniz aşağıdakilerden biri gibi görünebilir: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn=Factor%20IX%20assay&informationRecipient.languageCode.c=tr https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.languageCode.c =tr

İspanyolca konuşan biri için bilgi istemek için isteğiniz aşağıdakilerden biri gibi görünebilir: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria. v.dn=Factor%20IX%20assay&informationRecipient.languageCode.c=es https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.languageCode.c =es

Kabul Edilebilir Kullanım Politikası

MedlinePlus sunucularının aşırı yüklenmesini önlemek için NLM, MedlinePlus Connect kullanıcılarının IP adresi başına dakikada 100'den fazla istek göndermemesini şart koşar. Bu sınırı aşan isteklere hizmet verilmeyecek ve 300 saniye boyunca veya istek oranı sınırın altına düşene kadar (hangisi daha sonra gerçekleşirse) hizmet geri yüklenmeyecektir. NLM, Connect'e gönderdiğiniz isteklerin sayısını sınırlamak için sonuçların 12-24 saatlik bir süre için önbelleğe alınmasını önerir.

Bu politika, hizmetin tüm kullanıcılar tarafından kullanılabilir ve erişilebilir durumda kalmasını sağlamak için uygulanmaktadır. MedlinePlus Connect'e çok sayıda istek göndermenizi ve dolayısıyla bu politikada belirtilen talep oranı sınırını aşmanızı gerektiren özel bir kullanım durumunuz varsa, lütfen bizimle iletişime geçin. NLM personeli, talebinizi değerlendirecek ve bir istisna verilip verilmeyeceğini belirleyecektir. Lütfen MedlinePlus XML dosyaları belgelerini de inceleyin. Bu XML dosyaları, eksiksiz sağlık konusu kayıtları içerir ve MedlinePlus verilerine erişmek için alternatif bir yöntem olarak hizmet edebilir.

Daha fazla bilgi