IDigBio API v0 Specification: Difference between revisions

From iDigBio
Jump to navigation Jump to search
(add categories)
(add bold note)
Line 3: Line 3:
[[Category:Documentation]]
[[Category:Documentation]]


This document has been superceded by [[IDigBio API v1 Specification]]. Please use the current version of the API if possible.  
'''This document has been superceded by [[IDigBio API v1 Specification]]. Please use the current version of the API if possible. '''


Previous versions of the API (such as v0) may be less-fully documented than current versions.
Previous versions of the API (such as v0) may be less-fully documented than current versions.

Revision as of 10:55, 14 May 2014


This document has been superceded by IDigBio API v1 Specification. Please use the current version of the API if possible.

Previous versions of the API (such as v0) may be less-fully documented than current versions.

Available Types

$ curl -s "http://api.idigbio.org/v0/" | json_pp
{
   "records" : "http://api.idigbio.org/v0/records",
   "recordsets" : "http://api.idigbio.org/v0/recordsets",
   "mediaaps" : "http://api.idigbio.org/v0/mediaaps",
   "mediarecords" : "http://api.idigbio.org/v0/mediarecords"
}

Available endpoints

All endpoints follow the form of "http://api.idigbio.org/{api_version}{endpoint}"

iDigBio v0 API Endpoints
Endpoint Method Description
'/mediarecords' GET returns a collection of media record IDs
'/mediarecords/{ID}' GET returns a media record with the specific entity ID
'/mediarecords/{ID}/media' GET returns an image associated with the specific entity ID
'/records' GET returns a collection of record IDs
'/records/{ID}' GET returns a record with the specific entity ID
'/records/{ID}/media' GET returns an image associated with the specific entity ID
'/publishers' GET returns a collection of publisher IDs
'/publishers/{ID}' GET returns a publisher with specific entity ID
'/recordsets' GET returns a collection of recordset IDs
'/recordsets/{ID}' GET returns a recordset with specific entity ID