You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 6 Next »

Description

Returns a list of orders, families and species which are covered by Neotropical Birds Online as well as the status of each species account in Neotropical Birds. These are ordered base on the Clements world taxonomy.

Note:  Species accounts which have both article-complete and article-stub value of 0 may or may not exist in the Neotropical Birds site.  Only accounts which have a designation of article-complete=1 or article-stub=1 will be guaranteed to have a species account.  Do not link to any account which has both article-complete and article-stub value of 0

 This is part of the Neotropical Birds version 1.0 API.

URL

Base URL

http://neotropical.birds.cornell.edu/ws1.0/ref/taxa

Result Fields

Field (XML)

Attribute

Description

taxon-list

 

Parent tag


template-url

Partial URL to be combined with the species id to construct a link to a Neotropical Birds species account


locale

locale of the response, Current support for en_US only

order

 

Taxonomic rank of Order


sci-name

Scientific name of the Order


has-complete

0/1 boolean flag designating whether this Order contains complete species accounts


has-stub

0/1 boolean flag designating whether this Order contains stub or partial species accounts

family

 

Taxonomic rank of Family


sci-name

Scientific name of the Family


has-complete

0/1 boolean flag designating whether this Familycontains complete species accounts


has-stub

0/1 boolean flag designating whether this Familycontains stub or partial species accounts

species

 

Taxonomic rank of Species


com-name

Common name of this species in the locale from the taxon-list tag


sci-name

Scientific name


article-complete

Common name


article-stub

Common name


id

species "id" concatenated to the end of the template-url to generate the species account link

Example Responses

XML

<taxon-list template-url="http://neotropical.birds.cornell.edu/portal/species/overview?p_p_spp=" locale="en_US">
   <order sci-name="Struthioniformes" has-complete="0" has-stub="1">
      <family sci-name="Rheidae" has-complete="0" has-stub="1">
         <species com-name="Greater Rhea" sci-name="Rhea americana" article-complete="0" article-stub="1" id="55956"/>
         <species com-name="Lesser Rhea" sci-name="Rhea pennata" article-complete="0" article-stub="0" id="56116"/>
      </family>
   </order>
   <order sci-name="Tinamiformes" has-complete="1" has-stub="1">
      <family sci-name="Tinamidae" has-complete="1" has-stub="0">
         <species com-name="Tawny-breasted Tinamou" sci-name="Nothocercus julius" article-complete="0" article-stub="0" id="56276"/>
         <species com-name="Highland Tinamou" sci-name="Nothocercus bonapartei" article-complete="1" article-stub="0" id="56436"/>
         <species com-name="Hooded Tinamou" sci-name="Nothocercus nigrocapillus" article-complete="0" article-stub="0" id="56596"/>
         .
         .
         .
      </family>
   </order>
</taxon-list>
  • No labels