<html><head><meta http-equiv="Content-Type" content="text/html charset=windows-1252"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;">Hi Jörg,<div><br></div><div>I don't wanna go into the details of how our crawling works, but machine tags in general are for a special audience and often represent state for the authority that issued them.</div><div>I would recommend you not to rely on any of our machine tags. The structure and use patterns might change as we need them.</div><div><br></div><div>The safest way to find out the conceptual schemas is to investigate the endpoints directly using the native protocols.</div><div><br></div><div>The endpoint lacking a URI is interesting and likely a bug. Ive created a jira to be followed up by us:</div><div><a href="http://dev.gbif.org/issues/browse/POR-2355">http://dev.gbif.org/issues/browse/POR-2355</a></div><div><br></div><div>If you wanna know more about the current crawling let us know and we try our best once staff is back from holidays ;)</div><div><br></div><div><div>Thanks,</div></div><div>Markus</div><div><br></div><div><br></div><div><br><div><div>On 17 Jul 2014, at 11:18, Holetschek, Jörg <<a href="mailto:j.holetschek@bgbm.org">j.holetschek@bgbm.org</a>> wrote:</div><br class="Apple-interchange-newline"><blockquote type="cite"><div lang="EN-US" link="blue" vlink="purple" style="font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;"><div class="WordSection1" style="page: WordSection1;"><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;"><span style="font-size: 11pt; font-family: Calibri, sans-serif; color: rgb(31, 73, 125);">Hi Markus,<o:p></o:p></span></div><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;"><span style="font-size: 11pt; font-family: Calibri, sans-serif; color: rgb(31, 73, 125);"> </span></div><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;"><span style="font-size: 11pt; font-family: Calibri, sans-serif; color: rgb(31, 73, 125);">Great to have the final version of the API available! I used it to find out metadata about datasets from the registry and I found some odd datasets.<o:p></o:p></span></div><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;"><span style="font-size: 11pt; font-family: Calibri, sans-serif; color: rgb(31, 73, 125);"> </span></div><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;"><span style="font-size: 11pt; font-family: Calibri, sans-serif; color: rgb(31, 73, 125);">For BioCASe/DiGIR/TAPIR endpoints, the conceptualSchema usually can be found in the machineTags of the respective endpoint, or in the machineTags of the dataset (e.g.<span class="Apple-converted-space"> </span><a href="http://api.gbif.org/v1/dataset/88b04a08-f762-11e1-a439-00145eb45e9a" style="color: purple; text-decoration: underline;">http://api.gbif.org/v1/dataset/88b04a08-f762-11e1-a439-00145eb45e9a</a>).<o:p></o:p></span></div><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;"><span style="font-size: 11pt; font-family: Calibri, sans-serif; color: rgb(31, 73, 125);"> </span></div><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;"><span style="font-size: 11pt; font-family: Calibri, sans-serif; color: rgb(31, 73, 125);">But I came across many BioCASe/DiGIR/TAPIR endpoints with no according machineTag, for example<o:p></o:p></span></div><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;"><span style="font-size: 11pt; font-family: Calibri, sans-serif; color: rgb(31, 73, 125);"><a href="http://api.gbif.org/v1/dataset/82c788c2-f762-11e1-a439-00145eb45e9a" style="color: purple; text-decoration: underline;">http://api.gbif.org/v1/dataset/82c788c2-f762-11e1-a439-00145eb45e9a</a><span class="Apple-converted-space"> </span>(BioCASe)<o:p></o:p></span></div><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;"><span style="font-size: 11pt; font-family: Calibri, sans-serif; color: rgb(31, 73, 125);"><a href="http://api.gbif.org/v1/dataset/85275ce6-f762-11e1-a439-00145eb45e9a" style="color: purple; text-decoration: underline;"><span lang="DE">http://api.gbif.org/v1/dataset/85275ce6-f762-11e1-a439-00145eb45e9a</span></a></span><span lang="DE" style="font-size: 11pt; font-family: Calibri, sans-serif; color: rgb(31, 73, 125);"><span class="Apple-converted-space"> </span>(DiGIR)<o:p></o:p></span></div><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;"><span lang="DE" style="font-size: 11pt; font-family: Calibri, sans-serif; color: rgb(31, 73, 125);"><a href="http://api.gbif.org/v1/dataset/0e6799d0-13e6-11de-b2e1-b8a03c50a862" style="color: purple; text-decoration: underline;"><span lang="EN-US">http://api.gbif.org/v1/dataset/0e6799d0-13e6-11de-b2e1-b8a03c50a862</span></a></span><span style="font-size: 11pt; font-family: Calibri, sans-serif; color: rgb(31, 73, 125);"><span class="Apple-converted-space"> </span>(TAPIR)<o:p></o:p></span></div><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;"><span style="font-size: 11pt; font-family: Calibri, sans-serif; color: rgb(31, 73, 125);"> </span></div><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;"><span style="font-size: 11pt; font-family: Calibri, sans-serif; color: rgb(31, 73, 125);">Is that intended? How is it possible to find out the conceptualSchema for these endpoints?<o:p></o:p></span></div><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;"><span style="font-size: 11pt; font-family: Calibri, sans-serif; color: rgb(31, 73, 125);"> </span></div><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;"><span style="font-size: 11pt; font-family: Calibri, sans-serif; color: rgb(31, 73, 125);">(I also found one endpoint that lacks the ‘url’ field, but I guess that’s just a freak:<o:p></o:p></span></div><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;"><span style="font-size: 11pt; font-family: Calibri, sans-serif; color: rgb(31, 73, 125);"><a href="http://api.gbif.org/v1/dataset/3c7d6270-9681-11dc-8149-b8a03c50a862" style="color: purple; text-decoration: underline;">http://api.gbif.org/v1/dataset/3c7d6270-9681-11dc-8149-b8a03c50a862</a>)<o:p></o:p></span></div><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;"><span style="font-size: 11pt; font-family: Calibri, sans-serif; color: rgb(31, 73, 125);"> </span></div><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;"><span style="font-size: 11pt; font-family: Calibri, sans-serif; color: rgb(31, 73, 125);"> </span></div><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;"><span lang="DE" style="font-size: 11pt; font-family: Calibri, sans-serif; color: rgb(31, 73, 125);">Cheers,<o:p></o:p></span></div><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;"><span lang="DE" style="font-size: 11pt; font-family: Calibri, sans-serif; color: rgb(31, 73, 125);">Jörg<o:p></o:p></span></div><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;"><span lang="DE"> </span></div><div><div style="border-style: solid none none; border-top-color: rgb(181, 196, 223); border-top-width: 1pt; padding: 3pt 0cm 0cm;"><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;"><b><span lang="DE" style="font-size: 10pt; font-family: Tahoma, sans-serif;">Von:</span></b><span lang="DE" style="font-size: 10pt; font-family: Tahoma, sans-serif;"> </span><span style="font-size: 10pt; font-family: Tahoma, sans-serif;"><a href="mailto:api-users-bounces@lists.gbif.org" style="color: purple; text-decoration: underline;"><span lang="DE">api-users-bounces@lists.gbif.org</span></a></span><span lang="DE" style="font-size: 10pt; font-family: Tahoma, sans-serif;"><span class="Apple-converted-space"> </span>[</span><span style="font-size: 10pt; font-family: Tahoma, sans-serif;"><a href="mailto:api-users-bounces@lists.gbif.org" style="color: purple; text-decoration: underline;"><span lang="DE">mailto:api-users-bounces@lists.gbif.org</span></a></span><span lang="DE" style="font-size: 10pt; font-family: Tahoma, sans-serif;">]<span class="Apple-converted-space"> </span><b>Im Auftrag von<span class="Apple-converted-space"> </span></b>Markus Döring<br><b>Gesendet:</b><span class="Apple-converted-space"> </span>Freitag, 11.<span class="Apple-converted-space"> </span></span><span style="font-size: 10pt; font-family: Tahoma, sans-serif;">Juli 2014 15:19<br><b>An:</b><span class="Apple-converted-space"> </span><a href="mailto:api-users@lists.gbif.org" style="color: purple; text-decoration: underline;">api-users@lists.gbif.org</a><br><b>Betreff:</b><span class="Apple-converted-space"> </span>[API-users] GBIF API v1.0 live<o:p></o:p></span></div></div></div><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;"><o:p> </o:p></div><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;">Dear GBIF API users,<br><br>sorry for the far too long downtime today, but the good news is that version 1.0 of the API is finally live now!<o:p></o:p></div><div><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;"><a href="http://api.gbif.org/v1/" style="color: purple; text-decoration: underline;">http://api.gbif.org/v1/</a><o:p></o:p></div></div><div><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;"><o:p> </o:p></div></div><div><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;">You can find the updated documentation here as usual:<o:p></o:p></div></div><div><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;"><a href="http://www.gbif.org/developer" style="color: purple; text-decoration: underline;">http://www.gbif.org/developer</a><o:p></o:p></div></div><div><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;"><o:p> </o:p></div></div><div><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;">The previous v0.9 API URL will still be running up to the end of August, serving the exact same content.<o:p></o:p></div></div><div><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;"><br>Hope you enjoy it.<br>with best wishes,<o:p></o:p></div></div><div><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;"><o:p> </o:p></div></div><div><div style="margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: 'Times New Roman', serif;">your GBIF dev team<br><br><br><br><br>Version 1.0 changes:<br>----------------------------<br>- remove all underscores from URLs and replace them with camelCase (mainly species & metrics API)<br>- dataset.owningOrganizationKey renamed to dataset.publishingOrganizationKey<br>- use of lists instead of simple strings for email, phone, homepage, position and address for contacts, organization and node in the registry<br>- include issue column in dwca download<br>- search facets use country iso 2letter codes<br>- species & dataset suggest returns minimal information now: <a href="http://api.gbif-uat.org/v0.9/species/suggest?q=Dracul" style="color: purple; text-decoration: underline;">http://api.gbif-uat.org/v0.9/species/suggest?q=Dracul</a><br>- remove reverse geocode & mendeley GBIF articles from our API</div></div></div></div></blockquote></div><br></div></body></html>