publicdata/nih-gov
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
nih-gov/www.nlm.nih.gov/pubs/techbull/ja12/ja12_mplus_web_services.html
Scott Williams 7bcb500d37 Initial commit.
2025-02-26 13:17:41 -05:00

259 lines
17 KiB
HTML
Raw Blame History

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<meta http-equiv="X-UA-Compatible" content="IE=8;" />
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:site" content="@NLM_NIH">
<meta name="twitter:title" content="MedlinePlus XML Files and Web Service Enhancements. NLM Technical Bulletin. 2012 Jul&#8211;Aug">
<meta name="twitter:description" content=" The NLM Technical Bulletin is your source to stay informed about NLM products and services.">
<meta name="twitter:image" content="https://www.nlm.nih.gov/pubs/techbull/images/nlm_tech_bulletin_graphic_twitter.jpg">
<meta property="og:url" content="https://www.nlm.nih.gov/pubs/techbull/tb.html" />
<meta property="og:type" content="article" />
<meta property="og:title" content="MedlinePlus XML Files and Web Service Enhancements. NLM Technical Bulletin. 2012 Jul&#8211;Aug" />
<meta property="og:description" content="The NLM Technical Bulletin is your source to stay informed about NLM products and services." />
<meta property="og:image" content="https://www.nlm.nih.gov/pubs/techbull/images/nlm_tech_bulletin_graphic_facebook.jpg" />
<link type="text/css" href="/pubs/techbull/styles/reset.css" rel="stylesheet" />
<link type="text/css" href="/pubs/techbull/styles/technicalBulletin.css" rel="stylesheet" />
<!--Call jQuery-->
<script src="//assets.nlm.nih.gov/jquery/jquery-latest.min.js"></script>
<script src="//assets.nlm.nih.gov/jquery/jquery-migrate-latest.min.js"></script>
<script src="/pubs/techbull/scripts/techbull.js" type="text/javascript" language="javascript"></script>
<!--[if lte IE 8]>
<script type="text/javascript" src="/scripts/PIE.js"></script>
<![endif]-->
<link type="text/css" href="/pubs/techbull/styles/print.css" rel="stylesheet" media="print"/>
<title>MedlinePlus XML Files and Web Service Enhancements. NLM Technical Bulletin. 2012 Jul&#8211;Aug</title>
<link rel="schema.DC" href="http://purl.org/dc/elements/1.1/" title="The Dublin Core metadata Element Set" />
<meta name="DC.Title" content="MedlinePlus XML Files and Web Service Enhancements" />
<meta name="DC.Publisher" content="U.S. National Library of Medicine" />
<meta name="DC.Date.Issued" content="2012-07-03" />
<meta name="DC.Date.Modified" content="2014-02-14" />
<meta name="NLMDC.Date.LastReviewed" content="2014-02-14" />
<meta name="NLM.Contact.Email" content="nlmtechbull@mail.nlm.nih.gov" />
<meta name="DC.Type" content="Newsletters" />
<meta name="NLM.Permanence.Level" content="Permanent: Stable Content" />
<meta name="NLM.Permanence.Guarantor" content="U.S. National Library of Medicine" />
<meta name="DC.Rights" content="Public Domain" />
<meta name="DC.Language" content="eng" />
<meta name="DC.Subject.Keyword" content="Language" />
<meta name="DC.Subject.Keyword" content="Title" />
<meta name="DC.Subject.Keyword" content="Update" />
<meta name="DC.Subject.Keyword" content="MedlinePlus" />
<meta name="DC.Subject.Keyword" content="Extensible Markup Language" />
<meta name="DC.Subject.Keyword" content="Web Services" />
<meta name="DC.Subject.Keyword" content="Spanish" />
<meta name="DC.Subject.Keyword" content="E-mail" />
<meta name="DC.Subject.Keyword" content="MedlinePlus Health Topics" />
<meta name="DC.Subject.Keyword" content="feature" />
<meta name="DC.Subject.Keyword" content="Medical Subject Headings" />
<meta name="DC.Subject.Keyword" content="Release" />
<meta name="DC.Subject.Keyword" content="Date Created" />
<meta name="DC.Subject.Keyword" content="Metadata" />
<meta name="DC.Subject.Keyword" content="National Institutes of Health" />
<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start': new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src='//www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);})(window,document,'script','dataLayer','GTM-MT6MLL');</script>
<!-- End Google Tag Manager -->
</head>
<body>
<!-- Google Tag Manager -->
<noscript><iframe src="//www.googletagmanager.com/ns.html?id=GTM-MT6MLL" height="0" width="0" style="display:none;visibility:hidden" title="googletagmanager"></iframe></noscript>
<!-- End Google Tag Manager -->
<div class="skipnavigation"><a title="Skip the navigation on this page" href="#skipnav" class="skipnavigation">Skip Navigation Bar</a></div>
<div>
<div class="header">
<img src="/pubs/techbull/images/tb_logo_113.jpg" alt="National Library of Medicine Technical Bulletin" title="National Library of Medicine Technical Bulletin" /><img src="/pubs/techbull/images/nlm_masthead_113.jpg" alt="National Library of Medicine Technical Bulletin" title="National Library of Medicine Technical Bulletin" usemap="#nlm_masthead_113" />
</div>
<div class="search_box">
<form method="get" action="//vsearch.nlm.nih.gov/vivisimo/cgi-bin/query-meta" target="_self" name="searchForm" class="searchForm">
<label class="displaynone" for="search">Search</label>
<input name="query" id="search" type="text" class="search-input inactive" size="50" onfocus="this.value=''" value="Search here for NLM Technical Bulletin articles" aria-label="Search NLM Technical Bulletin">
<input type="hidden" name="v:project" value="technical-bulletin">
</form>
</div>
</div>
<div id="nav">
<!--Open drop-->
<ul class="topnav">
<li class="currentissue"><a href="//www.nlm.nih.gov/pubs/techbull/current_issue.html">Current Issue</a> <img class="separator" src="/pubs/techbull/images/whitelinetransparentbackground.gif " alt=""/></li>
<li class="archive"><a href="//www.nlm.nih.gov/pubs/techbull/back_issues.html">Previous Issues</a> <img class="separator" src="/pubs/techbull/images/whitelinetransparentbackground.gif " alt=""/></li>
<li class="about"><a href="//www.nlm.nih.gov/pubs/techbull/about.html">About</a> <img class="separator" src="/pubs/techbull/images/whitelinetransparentbackground.gif " alt=""/></li>
<li class="staycurrent"><a href="//www.nlm.nih.gov/pubs/techbull/stay_current.html">Stay Current <img class="emaillogo" src="/pubs/techbull/images/email_20px.gif" alt="E-Mail Sign Up" style="margin-top: -4px;"/> <img class="rsslogo" src="/pubs/techbull/images/rss_20px.gif" alt="RSS Feed" style="margin-top: -4px;"/></a></li>
</ul>
<!--Close drop-->
</div>
<div class="body">
<a id="skipnav" name="skipnav"></a>
<div class="syndicate">
<p class="tableOfContents"><strong>Table of Contents: <a href="/pubs/techbull/ja12/ja12_issue_cover.html">2012 JULY&#8211;AUGUST No. 387</a></strong></p>
<p class="prevnext"><span class="buttons">
<span class="previous"><a href="ja12_issue_cover.html">Previous</a></span> <span class="next"><a href="ja12_myncbi_new_features.html">Next</a></span>
</span></p>
<hr class="hr1" />
<h1 class="articleH1">MedlinePlus XML Files and Web Service Enhancements</h1>
<p class="tbyearmonth">Burgess S. MedlinePlus XML Files and Web Service Enhancements. NLM Tech Bull. 2012 Jul-Aug;(387):e1. </p>
<div class="articleactions">2012 July 03 <span class="status">[posted]</span>
</div>
<div class="articleParagraph">
<p>In June 2012, the National Library of Medicine (NLM) added new content and several new features to the MedlinePlus XML files and Web service. These enhancements make MedlinePlus XML data more robust, accessible, and flexible for users. </p>
<h2> MedlinePlus XML Files
</h2>
<p>
In June, NLM began publishing the MedlinePlus XML files in a new format with a new DTD. These files provide additional content that was not available in the earlier version of the files. The new <a href="//www.nlm.nih.gov/medlineplus/xml.html">XML files</a> contain all MedlinePlus English and Spanish health topics and associated data, which includes:
</p>
<br />
<ul>
<li>basic metadata (health topic title, URL, language, date created, and ID),</li>
<li>vocabulary (MeSH, "Also called" terms, see references),</li>
<li>full summary,</li>
<li>group membership,</li>
<li>related health topics,</li>
<li>equivalent English or Spanish topics,</li>
<li>related content in other languages,</li>
<li>primary NIH institute, and</li>
<li>all site records (links) assigned to a health topic page, including their names, URLs, organizations, category assignments, and standard descriptions.</li>
</ul>
<p>
With this release, most text and links available on MedlinePlus health topic pages become accessible in XML format. For complete details on all elements and attributes in the MedlinePlus health topic XML, see the MedlinePlus <a href="//www.nlm.nih.gov/medlineplus/xmldescription.html">XML file description</a>.</p>
<p> NLM also publishes a health topic group XML file. The health topic group XML contains information on MedlinePlus <a href="//www.nlm.nih.gov/medlineplus/healthtopics.html">topic groups</a> and now uses a new format and DTD.</p>
<p> NLM updates and posts the new MedlinePlus health topic XML files daily (Tuesday-Saturday) in compressed (.zip) and uncompressed formats. All of the new MedlinePlus XML files are published daily to correspond to the update schedule of the <a href="//www.nlm.nih.gov/medlineplus/">MedlinePlus.gov</a> Web site. Links to the six most recent XML data sets and the new DTDs are available from the MedlinePlus <a href="//www.nlm.nih.gov/medlineplus/xml.html">XML files</a> page. NLM does not publish delta files for the new XML data sets.</p>
<p> To continue receiving the most up-to-date MedlinePlus information, users of the earlier version of the MedlinePlus XML files need to transition over to the new files. NLM will continue to post updated files using the earlier format and DTD through the end of July 2012. After July 2012, NLM will only publish updated XML content via the new version of the files, and earlier versions of the MedlinePlus XML files will no longer be available. </p>
<h2> MedlinePlus Web Service</h2>
<p> In June, NLM also added several new features, parameters, content, and policies to the MedlinePlus <a href="//www.nlm.nih.gov/medlineplus/webservices.html">Web service</a>. The MedlinePlus Web service allows systems to send keyword-based queries to retrieve matching health topics in XML format. Existing users can continue to send requests and receive responses in the same format as they were using prior to June. The enhancements to the MedlinePlus Web service are detailed below, and publicly available <a href="//www.nlm.nih.gov/medlineplus/webservices.html">documentation</a> reflects the changes.</p>
<p> NLM now offers a Spanish version of the MedlinePlus Web service that accepts Spanish-language queries and responds with Spanish health topics. Users can send requests to the MedlinePlus Spanish Web service by sending the <em>healthTopicsSpanish</em> value for the <em>db</em> parameter in their queries.</p>
<p> The MedlinePlus Web service also now allows for optional field searching in queries. Users can accomplish field searching by including limiters in the <em>term</em> parameter to restrict the search to a specific health topic field. Fields that can be searched this way are <em>title</em>, <em>alt-title</em>, <em>mesh</em>, <em>full-summary</em>, and <em>group</em>.</p>
<p> Users of the MedlinePlus Web service can use the new optional <em>rettype</em> parameter to select from three possible result formats: <em>brief</em>, <em>topic</em>, and <em>all</em>. By default, results are returned in brief format if no <em>rettype</em> is specified in the request. The <em>brief</em> format was the only format available prior to June. The <em>topic</em> format returns the health topic results as full XML records with all associated data and links. The XML format of the <em>topic</em> result type matches the format and DTD of health topics in the MedlinePlus <a href="//www.nlm.nih.gov/medlineplus/xml.html">XML files</a> (as described in the first section of this article). The most significant feature of the <em>topic</em> format is the inclusion of all site records from MedlinePlus health topic pages, including encyclopedia links, multiple language links, organization links, and much more. The <em>all</em> format returns health topics in both <em>brief</em> and <em>topic</em> format.</p>
<p> Two new optional parameters, <em>email</em> and <em>tool</em>, allow Web service users to specify a contact email address and the resource using the Web service, respectively. Including these parameters in requests can assist NLM in providing better service and allows NLM to contact users if there are problems with their queries.</p>
<p> With the release of these new features, parameters, and content, NLM published a new acceptable use policy for the MedlinePlus Web service in June. To ensure that the Web service is continually available for all users, the new policy states: </p>
<dl>
<dd>"In order to avoid overloading the MedlinePlus servers, NLM requires that users of the MedlinePlus Web service send no more than 85 requests per minute per IP address. Requests that exceed this limit will not be serviced, and service will not be restored until the request rate falls beneath the limit. The MedlinePlus Web service is updated once per day, Tuesday-Saturday. To limit the number of requests that you send to the Web service, NLM recommends caching results for a 12-24 hour period.<br /><br /></dd>
<dd>
This policy is in place to ensure that the service remains available and accessible to all users. NLM encourages all users of the MedlinePlus Web service to use the <em>email</em> and <em>tool</em> parameters. NLM may use this information to contact you if there are problems with your requests.<br /><br /></dd>
<dd>If you have a specific use case that requires you to send a large number of requests to the Web service, and thus exceed the request rate limit outlined in this policy, please <a href="//apps2.nlm.nih.gov/medlineplus/contact/index.cfm?lang=en&amp;from=//www.nlm.nih.gov/medlineplus/webservices.html">contact us</a>. NLM staff will evaluate your request and determine if an exception may be granted. Please also review the MedlinePlus <a href="//www.nlm.nih.gov/medlineplus/xml.html">XML files</a> documentation. These XML files contain complete health topic records and can serve as an alternate method of accessing MedlinePlus data."</dd>
</dl>
<p> Users who are currently sending more than 85 requests per minute per IP address to the MedlinePlus Web service will need to adjust the number and/or frequency of requests in order to avoid request throttling, which will result in requests not being serviced until the request rate falls beneath the limit. Although NLM published this policy in June, enforcement will not begin until July 16 to give users time to come into compliance.</p>
<p> NLM encourages users of MedlinePlus data to subscribe to the MedlinePlus Web Service and XML Files <a href="https://public.govdelivery.com/accounts/USNLMMP/subscriber/new?topic_id=USNLMMP_874">email list</a> to stay current on the latest changes and enhancements to these services. Send the MedlinePlus team any questions or feedback via the <a href="//apps2.nlm.nih.gov/medlineplus/contact/index.cfm?lang=en">Contact Us</a> link that appears on any MedlinePlus.gov page.</p>
</div>
<p class="articleParagraph">
By
Sarena Burgess<br />
Public Services Division<br />
</p>
</div>
<div class="footer">
<p class="footerLeft"><span class="footerissn"><strong>ISSN 2161-2986 (Online)</strong> Content not copyrighted; freely reproducible.</span><br/>
<a href="/">National Library of Medicine</a> 8600 Rockville Pike, Bethesda, MD 20894
<br/>
<a href="//www.nlm.nih.gov/socialmedia/index.html">Connect with NLM</a>,
<a href="//www.nlm.nih.gov/web_policies.html">Web Policies</a>,
<a href="//www.nlm.nih.gov/careers/jobopenings.html">Careers</a>,
<a href="//www.nlm.nih.gov/accessibility.html">Accessibility</a>,
<a href="//www.usa.gov/" id="anch_34">USA.gov</a>,
<a href="//www.hhs.gov/vulnerability-disclosure-policy/index.html">HHS Vulnerability Disclosure</a>
<br/>
<a href="//www.nih.gov/">NIH</a>,
<a href="https://www.hhs.gov/">HHS</a>,
<a href="//www.nih.gov/institutes-nih/nih-office-director/office-communications-public-liaison/freedom-information-act-office">FOIA</a>,
<a class="supportLink" href="//support.nlm.nih.gov?from=" target="_blank">NLM Support Center</a>
</p>
<p class="footerRight">
<strong>Last updated:</strong> 14 February 2014</p>
</div>
</div>
<map id="nlm_masthead_113" name="nlm_masthead_113">
<area shape="rect" alt="NLM Technical Bulletin" coords="1,15,396,45" href="//www.nlm.nih.gov/pubs/techbull/tb.html" title="NLM Technical Bulletin" />
<area shape="rect" alt="National Library of Medicine" coords="0,47,203,62" href="//www.nlm.nih.gov/" title="National Library of Medicine" />
<area shape="rect" coords="207,47,396,62" href="//www.nih.gov/" alt="National Institutes of Health" title="" />
</map>
<!--*****************************Content end*******************************-->
<script src="/scripts/support.js"></script>
<script src="/core/nlm-notifyExternal/1.0/nlm-notifyExternal.min.js"></script>
</body>
</html>
Reference in a new issue View git blame Copy permalink