<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
</head>
<body style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">
Dear all,
<div class=""><br class="">
</div>
<div class="">as you all know at the end of last year the Catalogue of Life has moved to a whole new infrastructure and now offers a new and richer API.</div>
<div class="">As I had a few similar requests vie email lately I thought it would be good to give you a quick introduction to get started, while we are still working on better documentation.</div>
<div class=""><br class="">
</div>
<div class=""><br class="">
</div>
<div class="">The basic concept has changed in the sense that the API does not only expose the Catalogue of Life (COL), but all of ChecklistBank (CLB) which hosts a large number of taxonomic or nomenclatural datasets including the sources that we use to assemble
the COL. You can read here more about it: <a href="https://www.catalogueoflife.org/about/colpipeline" class="">https://www.catalogueoflife.org/about/colpipeline</a></div>
<div class=""><br class="">
</div>
<div class="">The base URL of the API uses Swagger to exposes a rudimentary documentation of all the available REST resources and allows you to test it with real data: <a href="https://api.catalogueoflife.org" class="">https://api.catalogueoflife.org</a></div>
<div class=""><br class="">
</div>
<div class="">In order to access the latest version of COL you need to use the datasetKey=3LR (note that the swagger generated API docs do not allow strings, please use the currents release key 2242 for testing or curl). Pretty much all calls of interest to
you should be scoped under <a href="http://api.catalogueoflife.org/dataset/3LR" class="">http://api.catalogueoflife.org/dataset/3LR</a></div>
<div class=""><br class="">
</div>
<div class="">In order to search for a name you could be doing this:</div>
<div class=""><a href="http://api.catalogueoflife.org/dataset/3LR/nameusage/search?q=Abies&rank=SPECIES&status=ACCEPTED" class="">http://api.catalogueoflife.org/dataset/3LR/nameusage/search?q=Abies&rank=SPECIES&status=ACCEPTED</a></div>
<div class=""><br class="">
</div>
<div class="">To get taxon details for a given taxonID this does most of it:</div>
<div class="">Basics: <a href="http://api.catalogueoflife.org/dataset/2242/taxon/5QQJ9" class="">http://api.catalogueoflife.org/dataset/2242/taxon/5QQJ9</a></div>
<div class="">Full Infos: <a href="http://api.catalogueoflife.org/dataset/2242/taxon/5QQJ9/info" class="">http://api.catalogueoflife.org/dataset/2242/taxon/5QQJ9/info</a></div>
<div class=""><br class="">
</div>
<div class="">To browse the tree you can use the Tree API which in its basic form works like this:</div>
<div class="">Root taxa: <a href="http://api.catalogueoflife.org/dataset/3LR/tree" class="">http://api.catalogueoflife.org/dataset/3LR/tree</a></div>
<div class="">Plant Children: <a href="http://api.catalogueoflife.org/dataset/3LR/tree/P" class="">http://api.catalogueoflife.org/dataset/3LR/tree/P/children</a></div>
<div class=""><br class="">
</div>
<div class=""><br class="">
</div>
<div class="">We now also offer reusable React UI components that you can embed in your own site or application to browse the tree, search and present species pages: <a href="https://github.com/CatalogueOfLife/portal-components" class="">https://github.com/CatalogueOfLife/portal-components</a></div>
<div class=""><br class="">
</div>
<div class=""><br class="">
</div>
<div class="">
<div class="">We have also migrated the previous "legacy" API which you can access with the latest data from <a href="https://api.catalogueoflife.org/col/webservice?name=Abies alba&format=json&response=full" class="">https://api.catalogueoflife.org/col/webservice</a> like
this:</div>
<div class=""><a href="https://api.catalogueoflife.org/col/webservice?name=Abies alba&format=json&response=full" class="">https://api.catalogueoflife.org/col/webservice?name=Abies%20alba&format=json&response=full</a></div>
<div class=""><br class="">
</div>
<div class="">There are a few small differences how we treat references compared to the previous version, otherwise it should work just as before.</div>
<div class="">We do consider this a legacy API and would like to encourage everyone using it still to migrate to our new API above.</div>
</div>
<div class=""><br class="">
</div>
<div class=""><br class="">
</div>
<div class="">Please don't hesitate to ask any questions on this list if you want to know more on how to use our API.</div>
<div class=""><br class="">
</div>
<div class=""><br class="">
</div>
<div class="">With best wishes,</div>
<div class="">Markus</div>
<div class=""><br class="">
</div>
<div class=""><br class="">
</div>
<div class=""><br class="">
</div>
+++ COL RESOURCES +++<br class="">
<br class="">
COL Website:<br class="">
<a href="http://www.catalogueoflife.org/" class="">http://www.catalogueoflife.org/</a>
<div class=""><br class="">
COL ChecklistBank:<br class="">
<a href="http://data.catalogueoflife.org/" class="">http://data.catalogueoflife.org/</a>
<div class=""><br class="">
COL ChecklistBank API:<br class="">
<a href="http://api.catalogueoflife.org/" class="">http://api.catalogueoflife.org/</a>
<div class=""><br class="">
COL latest release in API:<br class="">
<div class=""><a href="http://api.catalogueoflife.org/dataset/3LR" class="">http://api.catalogueoflife.org/dataset/3LR</a></div>
<div class=""><br class="">
</div>
<div class=""><br class="">
</div>
<div class=""><br class="">
<div class="">
<div dir="auto" style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">
<div dir="auto" style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">
<div dir="auto" style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">
<div style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">
<div style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">
--<br class="">
Markus Döring</div>
<div style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">
Lead Developer Catalogue of Life<br class="">
Global Biodiversity Information Facility (GBIF)<br class="">
<div class=""><a href="mailto:mdoering@gbif.org" class="">mdoering@gbif.org</a></div>
<div class=""><a href="http://www.gbif.org/" class="">http://www.gbif.org</a></div>
<div class=""><br class="">
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</body>
</html>