[API-users] Best practice to read details info using the API

[Markus Döring]

Hi Martin,

I am afraid there is no single request. We also stitch the species page together from lots of different requests. For some of them there is the danger that they get pretty large, hence most of them are pageable too.
For the parents it depends whether you need the exact list of all parents. Then you need that extra request. If you can live with just the major Linnean ranks then you can use the family/familyKey property of the NameUsage object directly.

Cheers,
Markus


On 20 Dec 2015, at 18:04, Martin Wendt <gbif at wwwendt.de<mailto:gbif at wwwendt.de>> wrote:

Hello all,

I like to display an overview page for a distinct species like this:
http://www.gbif.org/species/4827561

Is there a common request that collects these information with one roundtrip, or do I have to issue the specialized calls separately
http://api.gbif.org/v1/species/4827561/
http://api.gbif.org/v1/species/4827561/speciesProfiles
http://api.gbif.org/v1/species/4827561/synonyms
…

A similar question arises, if i want to construct a breadcrumb for a given key, so I need the parent list *and* the target item.
Is there a shortcut or are these two calls required (like i do now):

http://api.gbif.org/v1/species/4827561/parents
http://api.gbif.org/v1/species/4827561/

I just want to make sure that I don’t generate more requests than necessary.
So if there are any policies like max. request rate, or a recommended additional request header to identify the user agent, please let me know.

Thanks
Martin

_______________________________________________
API-users mailing list
API-users at lists.gbif.org<mailto:API-users at lists.gbif.org>
http://lists.gbif.org/mailman/listinfo/api-users

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.gbif.org/pipermail/api-users/attachments/20151222/3932bd4b/attachment.html>