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:
- 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
- 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:
- 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
- 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 - İ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
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:
- 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
- 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
Bugünkü Popüler
İnsan Plasental Laktojeni: Hamileliğiniz Hakkında Size Ne Anlatabilir?
