Difference between revisions of "OJ Break API Reference"

From xBio:D Wiki
Jump to navigation Jump to search
(Updated the page to point to the new api urls.)
 
(271 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
'''Introduction'''
 
'''Introduction'''
  
−
OJ_Break is the name of the OSUC biodiversity RESTful(-like) API service. The API responds exclusively in JavaScript Object Notation (JSON) and accepts only HTTP GET and POST requests indiscriminately unlike a true REST API. Built using Oracle's PL/SQL database language, the API is fast but often inflexible and inconsistent, so take note of all of the comments below.
+
OJ_Break is the name of the xBio:D RESTful API service to facilitate discovery of data within the xBio:D database. The API can respond with JavaScript Object Notation (JSON), XML, or JSON with padding (JSONP) and accepts HTTP GET and POST requests indiscriminately. The backend of the API is written in Oracle's PL/SQL database language, which is fast but often inflexible, while a Python presentation layer mitigates request handling and authentication.
  
  
−
== Overview ==
+
The reference for version 2 of the API can be found here: [[OJ_Break_Version_2_API_Reference]]
−
All API requests must be formatted by first selecting the OJ_Break library then specifying the API method. Also, each method must include a callback argument even if a callback function is unnecessary (e.g. jQuery AJAX requests).
 
  
−
The format for API calls is: '''''<nowiki>http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.[method]?[argument1]=[value1]&...</nowiki>'''''
 
−
* Example: '''''<nowiki>http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getTaxonInfo?tnuid=5012&callback=test</nowiki>'''''
 
−
* Response: '''''test({"taxon":"Oxyscelio consobrinus","author":"(Kieffer)","status":"Subsequent name/combination","rank":"Species","valid":"Valid","fossil":"N","rel_type":"Member",...'''''
 
  
 +
== API Information and Access ==
 +
This page specifies the methods and data defined by OJ_Break Version 1. Using the OJ_Break Version 1 API requires calling methods with corresponding, method specific parameters (found in this page) and a few other required parameters. These include specifying a return ''format'' and an API access ''key''.
  
−
== Reference ==
+
    Example: https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getTaxonStats?tnuid=30148&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
−
=== Procedures ===
+
 
−
==== Taxon ====
+
To read more about using the OJ_Break Version 1 API, go to [[OJ_Break API Access]].
−
===== getTaxonStats =====
+
 
−
====== Description ======
+
== Procedural Reference ==
 +
=== Agent ===
 +
==== getCollectorInfo ====
 +
===== Description =====
 +
===== Parameters =====
 +
* ''collector_id'': number
 +
* ''format'': string
 +
* ''key'': string
 +
===== Return =====
 +
* ''collector_info'': array of author_info
 +
 
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getCollectorInfo?collector_id=2&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 
 +
==== getAuthorPubs ====
 +
===== Description =====
 +
===== Parameters =====
 +
* ''author_id'': number
 +
* ''format'': string
 +
* ''key'': string
 +
===== Return =====
 +
* ''pubs'': array of literature_extended
 +
 
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getAuthorPubs?author_id=2&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 
 +
==== getCollTrips2 ====
 +
===== Description =====
 +
===== Parameters =====
 +
* ''collector_id'': number
 +
* ''format'': string
 +
* ''key'': string
 +
===== Return =====
 +
* ''coll_trips'': array of collection_basic, taxon_basic, loc_coords, and collector.
 +
 
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getCollTrips2?collector_id=2&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 
 +
==== getAuthorTaxa ====
 +
===== Description =====
 +
===== Parameters =====
 +
* ''author_id'': number
 +
* ''format'': string
 +
* ''key'': string
 +
 
 +
===== Return =====
 +
''taxa'': array of taxon_basic
 +
 
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getAuthorTaxa?author_id=2&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 
 +
=== Taxon ===
 +
==== getTaxonStats ====
 +
===== Description =====
 
Get some basic taxonomic statistics for a taxon from a tnuid.
 
Get some basic taxonomic statistics for a taxon from a tnuid.
−
====== Parameters ======
+
===== Parameters =====
 
* ''tnuid'': number
 
* ''tnuid'': number
−
* ''callback'': string
+
* ''format'': string
−
====== Return ======
+
* ''key'': string
 +
===== Return =====
 
* ''taxon'': string
 
* ''taxon'': string
 
* ''author'': string
 
* ''author'': string
 
* ''stats'': taxon_stats
 
* ''stats'': taxon_stats
  
−
====== Example ======
+
===== Example =====
−
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getTaxonStats?tnuid=30148&callback=api
+
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getTaxonStats?tnuid=30148&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
  
−
===== getTaxonInfo =====
+
==== getTaxonInfo ====
−
====== Description ======
+
===== Description =====
 
Get some basic taxonomic information for a taxon from a tnuid.
 
Get some basic taxonomic information for a taxon from a tnuid.
−
====== Parameters ======
+
===== Parameters =====
 
* ''tnuid'': number
 
* ''tnuid'': number
 
* ''inst_id'': number
 
* ''inst_id'': number
−
* ''callback'': string
+
* ''format'': string
−
====== Return ======
+
* ''key'': string
−
* ''taxon'': string
+
===== Return =====
−
* ''author'': string
+
* ''taxon_rel_extended'' class with below extensions
−
* ''status'': string
 
−
* ''rank'': string
 
−
* ''rel_type'': string
 
 
* ''valid_taxon'': taxon_basic (only present when defined)
 
* ''valid_taxon'': taxon_basic (only present when defined)
 
* ''parent_taxon'': taxon_basic
 
* ''parent_taxon'': taxon_basic
−
* ''valid'': string
 
−
* ''fossil'': string
 
 
* ''hier'': taxon_hierarchy
 
* ''hier'': taxon_hierarchy
 
* ''source'': taxon_source
 
* ''source'': taxon_source
 +
* ''common_names'': array of common_name
 
* ''orig_desc'': contrib_literature_basic (only present when defined)
 
* ''orig_desc'': contrib_literature_basic (only present when defined)
 +
* ''stats'': taxon_info_stats
 +
* ''contribs'': array of contribution
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getTaxonInfo?tnuid=30148&inst_id=0&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
  
 +
==== getTaxonHierarchy ====
 +
===== Description =====
 +
Get the taxonomic hierarachy in which a taxon is at the terminal node from a tnuid.
 +
===== Parameters =====
 +
* ''tnuid'': number
 +
* ''format'': string
 +
* ''key'': string
 +
===== Return =====
 +
* ''taxon'': string
 +
* ''author'': string
 +
* ''hier'': taxon_hierarchy
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getTaxonHierarchy?tnuid=30148&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 +
==== getIncludedTaxa ====
 +
===== Description =====
 +
Get the taxa that are directly included within a taxon but not synonymous with it.
 +
===== Parameters =====
 +
* ''tnuid'': number
 +
* ''inst_id'': number
 +
* ''showSyns'': boolean_flag
 +
* ''showFossils'': boolean_flag
 +
* ''types_only'': boolean_flag
 +
* ''show_num_spms'': boolean_flag
 +
* ''format'': string
 +
* ''key'': string
 +
 +
===== Return =====
 +
* ''tnuid'': number
 +
* ''parent_tnuid'': number
 +
* ''includedTaxa'': array of taxon_extended
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getIncludedTaxa?tnuid=491&inst_id=0&showSyns=Y&showFossils=Y&types_only=N&show_num_spms=N&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 +
==== getTaxonSynonyms ====
 +
===== Description =====
 +
Get the taxa that are objectively or subjectively synonymous with a taxon.
 +
===== Parameters =====
 +
* ''tnuid'': number
 +
* ''showFossils'': boolean_flag
 +
* ''format'': string
 +
* ''key'': string
 +
 +
===== Return =====
 +
* ''synonyms'': array of taxon_rel_extended
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getTaxonSynonyms?tnuid=30148&showFossils=Y&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 +
==== getLocalities ====
 +
===== Description =====
 +
Get the localities from vouchered and unvouchered records for a taxon.
 +
===== Parameters =====
 +
* ''tnuid'': number
 +
* ''inst_id'': number
 +
* ''precDecimals'': number
 +
* ''showChildren'': boolean_flag
 +
* ''format'': string
 +
* ''key'': string
 +
 +
===== Return =====
 +
* ''localities'': array of loc_coords
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getLocalities?tnuid=30148&inst_id=0&precDecimals=4&showChildren=Y&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 +
==== getLocalities ====
 +
===== Description =====
 +
Get the localities within geopolitical divisions from vouchered and unvouchered records for a taxon.
 +
===== Parameters =====
 +
* ''tnuid'': number
 +
* ''pnids'': array of pnid
 +
* ''inst_id'': number
 +
* ''precDecimals'': number
 +
* ''showChildren'': boolean_flag
 +
* ''format'': string
 +
* ''key'': string
 +
 +
===== Return =====
 +
* ''localities'': array of loc_coords
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getLocalities?tnuid=30148&pnids=5816,5735&inst_id=0&precDecimals=4&showChildren=Y&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 +
==== getCuids ====
 +
===== Description =====
 +
Get the occurrence identifiers (collecting unit IDs) for a taxon.
 +
===== Parameters =====
 +
* ''tnuid'': number
 +
* ''showChildren'': boolean_flag
 +
* ''inst_id'': number
 +
* ''pnids'': array of pnid
 +
* ''format'': string
 +
* ''key'': string
 +
 +
===== Return =====
 +
* ''cuids'': array of cuid
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getCuids?tnuid=30148&showChildren=Y&inst_id=1&pnids=&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 +
==== getCuids ====
 +
===== Description =====
 +
Get the occurrence identifiers (collecting unit IDs) for selected taxa.
 +
===== Parameters =====
 +
* ''tnuids'': array of tnuid
 +
* ''pnids'': array of pnid
 +
* ''format'': string
 +
* ''key'': string
 +
 +
===== Return =====
 +
* ''cuids'': array of cuid
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getCuids?tnuids=30148,491&pnids=5816,5735&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 +
==== getTypes ====
 +
===== Description =====
 +
Gets information and specimen types for a specified taxon.
 +
 +
===== Parameters =====
 +
* ''tnuid'': number
 +
* ''showSyns'': boolean_flag
 +
* ''inst_id'': number
 +
* ''primary_only'': boolean_flag
 +
* ''taxon_author_search'': string
 +
* ''offset'': number
 +
* ''limit'': number
 +
* ''format'': string
 +
* ''key'': string
 +
 +
===== Return =====
 +
* ''num_records'': number
 +
* ''types'': array of type_extended
 +
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getTypes?tnuid=434&showSyns=F&inst_id=1&primary_only=Y&taxon_author_search=&offset=1&limit=10&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 +
==== getInsts ====
 +
===== Description =====
 +
Gets institutions which hold specimens for a selected taxon.
 +
 +
===== Parameters =====
 +
* ''tnuid'': number
 +
* ''format'': string
 +
* ''key'': string
 +
 +
===== Return =====
 +
* ''collections'': array of collection_extended
 +
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getInsts?tnuid=30148&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 +
==== getTaxonLiterature (deprecated) ====
 +
===== Description =====
 +
Deprecated. Use getTaxonLit instead
 +
===== Parameters =====
 +
* ''tnuid'': number
 +
* ''showSyns'': string
 +
* ''format'': string
 +
* ''key'': string
 +
 +
===== Return =====
 +
* ''lit'': pubs
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getTaxonLiterature?tnuid=30148&showSyns=Y&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 +
==== getTaxonLit ====
 +
===== Description =====
 +
Preferred. Get literature for a selected taxon.
 +
===== Parameters =====
 +
* ''tnuid'': number
 +
* ''showSyns'': boolean_flag
 +
* ''format'': string
 +
* ''key'': string
 +
 +
===== Return =====
 +
* ''pubs'': array of pub_extended
 +
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getTaxonLit?tnuid=30148&showSyns=Y&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 +
==== getAssociations ====
 +
===== Description =====
 +
Get evolutionary relationships for a certain taxon.
 +
===== Parameters =====
 +
* ''tnuid'': number
 +
* ''rank_grouping'': string
 +
* ''format'': string
 +
* ''key'': string
 +
 +
===== Return =====
 +
* ''associations'': array of association
 +
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getAssociations?tnuid=491&rank_grouping=&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 +
==== getHabitats ====
 +
===== Description =====
 +
Get descriptions of the habitats that a selected specimen inhabits.
 +
 +
===== Parameters =====
 +
* ''tnuid'': number
 +
* ''format'': string
 +
* ''key'': string
 +
 +
===== Return =====
 +
* ''habitats'': array of habitat
 +
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getHabitats?tnuid=30148&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 +
==== getTaxonMedia ====
 +
===== Description =====
 +
Get images, videos, or sound clips of a selected taxon.
 +
===== Parameters =====
 +
* ''tnuid'': number
 +
* ''format'': string
 +
* ''key'': string
 +
 +
===== Return =====
 +
* ''media'': array of media_basic
 +
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getTaxonMedia?tnuid=30148&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 +
==== getTaxonBreakdown ====
 +
===== Description =====
 +
Get count of genders and total specimen included in the current rank.
 +
===== Parameters =====
 +
* ''tnuid'': number
 +
* ''format'': string
 +
* ''key'': string
 +
 +
===== Return =====
 +
* ''taxa'': array of taxon_basic with below extension
 +
** ''count'': number
 +
* ''sex'': array of spm_sex
 +
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getTaxonBreakdown?tnuid=491&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 +
==== getTaxonPhenology ====
 +
===== Description =====
 +
Get taxon specimens by date.
 +
===== Parameters =====
 +
* ''tnuid'': number
 +
* ''format'': string
 +
* ''key'': string
 +
 +
===== Return =====
 +
* ''spms'': array of below elements
 +
** ''date'': string
 +
** ''sort_date'': string
 +
** ''cuid'': string
 +
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getTaxonPhenology?tnuid=30148&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 +
==== getTaxonNewTaxaByPub ====
 +
===== Description =====
 +
Get count of new specimens for a specific taxon by publication.
 +
===== Parameters =====
 +
* ''tnuid'': number
 +
* ''validOnly'': boolean_flag
 +
* ''format'': string
 +
* ''key'': string
 +
 +
===== Return =====
 +
* ''pubs'': array of literature_extended with below extension
 +
** ''taxa_num'': string
 +
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getTaxonNewTaxaByPub?tnuid=491&validOnly=Y&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 +
==== getTaxonNewTaxaByYear ====
 +
===== Description =====
 +
Get count of new specimens for a specific taxon by year.
 +
===== Parameters =====
 +
* ''tnuid'': number
 +
* ''validOnly'': string
 +
* ''format'': string
 +
* ''key'': string
 +
 +
===== Return =====
 +
* ''years'': array of below elements
 +
** ''taxa_num'': string
 +
** ''year'': string
 +
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getTaxonNewTaxaByYear?tnuid=52&validOnly=Y&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 +
==== getTaxonStatsForYear ====
 +
===== Description =====
 +
Get stats, such as image count, new genera introduced, new specimen introduced, and more by year for a selected taxon.
 +
===== Parameters =====
 +
* ''tnuid'': number
 +
* ''stats_year'': number
 +
* ''format'': string
 +
* ''key'': string
 +
 +
===== Return =====
 +
* ''stats'': array of below elements
 +
** ''new_spm_num'': number
 +
** ''all_spm_num'': number
 +
** ''new_taxa_spm_num'': array of number
 +
** ''all_taxa_spm_num'': array of number
 +
** ''new_images_num'': number
 +
** ''all_images_num'': number
 +
** ''spm_years'': array of string
 +
** ''images_years'': array of string
 +
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getTaxonStatsForYear?tnuid=30148&stats_year=2014&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 +
=== Occurrence ===
 +
==== Specimen Record ====
 +
===== getSpmInfo =====
 +
====== Description ======
 +
Get info for a specific specimen occurrence.
 +
====== Parameters ======
 +
* ''cuid'': string
 +
* ''format'': string
 +
* ''key'': string
 +
 +
====== Return ======
 +
* ''spmInfo'': record_vouchered
 
====== Example ======
 
====== Example ======
−
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getTaxonInfo?tnuid=30148&inst_id=0&callback=api
+
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getSpmInfo?cuid=OSUC+59557&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
  
 +
===== getSpmsInfo =====
 +
====== Description ======
 +
Get info for multiple specimen occurrences.
 +
====== Parameters ======
 +
* ''cuids'': array of string
 +
* ''format'': string
 +
* ''key'': string
  
−
{|
+
====== Return ======
−
! align="left"| Method
+
* ''spmsInfo'': array of record_vouchered
−
! align="left"| Return
+
====== Example ======
−
! align="left"| Description
+
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getSpmsInfo?cuids=OSUC+59557,OSUC+56308&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
−
|-
+
 
−
|getTaxonInfo(tnuid:number, callback:string)
+
==== Unvouchered Record ====
−
|
+
===== getUnvoucheredRecord =====
−
|
+
====== Description ======
−
|-
+
Get specimen record information for a selected unvouchered specimen.
−
|getTaxonHierarchy(tnuid:number, callback:string)
+
====== Parameters ======
−
|
+
* ''unv_id'': number
−
|
+
* ''format'': string
−
|-
+
* ''key'': string
−
|getIncludedTaxa(tnuid:number, showSyns:<nowiki>Y|N</nowiki>, showFossils:<nowiki>Y|N</nowiki>, inst_id:number, types_only:<nowiki>Y|N|P</nowiki>, show_num_spms:<nowiki>Y|N</nowiki>, callback:string)
+
 
−
|
+
====== Return ======
−
|
+
* ''unvoucheredRecord'': record_unvouchered
−
|-
+
 
−
|getTaxonSynonyms(tnuid:number, showFossils:<nowiki>Y|N</nowiki>, callback:string)
+
====== Example ======
−
|
+
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getUnvoucheredRecord?unv_id=1&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
−
|
+
 
−
|-
+
===== getUnvoucheredRecords =====
−
|getLocalities(tnuid:number, inst_id:number, precDecimals:number, showChildren:<nowiki>Y|N</nowiki>, callback:string)
+
====== Description ======
−
|
+
Get unvouchered specimen records for a selected taxon and place.
−
|
+
====== Parameters ======
−
|-
+
* ''tnuid'': number
−
|getLocalities(tnuid:number, inst_id:number, pnids:array of number, precDecimals:number, showChildren:<nowiki>Y|N</nowiki>, callback:string)
+
* ''showChildren'': string
−
|
+
* ''pnids'': array of number
−
|
+
* ''format'': string
−
|-
+
* ''key'': string  
−
|getCuids(tnuids:array of number, pnids:array of number, callback:string)
+
 
−
|
+
====== Return ======
−
|
+
* ''unvoucheredRecords'': array of record_unvouchered
−
|-
+
 
−
|getCuids(tnuid:number, showChildren:<nowiki>Y|N</nowiki>, inst_id:number, pnids:array of number, callback:string)
+
====== Example ======
−
|
+
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getUnvoucheredRecords?tnuid=44&showChildren=Y&pnids=&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
−
|
+
 
−
|-
+
=== Locality ===
−
|getTypes(tnuid:number, showSyns:<nowiki>Y|N</nowiki>, inst_id:number, primary_only:<nowiki>Y|N</nowiki>, taxon_author_search:string, offset:number, limit:number, callback:string)
+
==== getLocalityInfo ====
−
|
+
===== Description =====
−
|
+
Get basic information for a specific locality, including specimen occurrences, place hierarchy, and coordinates.
−
|-
+
===== Parameters =====
−
|getInsts(tnuid:number, callback:string)
+
* ''loc_id'': number
−
|
+
* ''tnuid'': number
−
|
+
* ''inst_id'': number
−
|-
+
* ''per_id'': number
−
|getTaxonLiterature(tnuid:number, showSyns:<nowiki>Y|N</nowiki>, callback:string)
+
* ''pnid'': number
−
|
+
* ''showChildren'': string
−
|
+
* ''completeSpmInfo'': string
−
|-
+
* ''format'': string
−
|getAssociations(tnuid:number, rank_grouping:string, callback:string)
+
* ''key'': string
−
|
+
 
−
|
+
===== Return =====
−
|-
+
* ''locInfo'': array of loc_info with below extensions
−
|getHabitats(tnuid:number, callback:string)
+
** ''hier'': array of place
−
|
+
** ''cuids'': array of record_vouchered (only present if specified) or array of cuid
−
|
+
** ''sex'': array of spm_sex
−
|-
+
 
−
|getTaxonImages(tnuid:number, callback:string)
+
===== Example =====
−
|
+
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getLocalityInfo?loc_id=1&tnuid=30148&inst_id=1&per_id=1&pnid=1&showChildren=Y&completeSpmInfo=Y&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
−
|
+
 
−
|-
+
==== getUnvLocalityInfo ====
−
|getTaxonBreakdown(tnuid:number, callback:string)
+
===== Description =====
−
|
+
Get locality information and occurrences (specimens) for a selected locality. The request can be narrowed down further by selected multiple parameter options.
−
|
+
===== Parameters =====
−
|-
+
* ''loc_id'': number
−
|getTaxonPhenology(tnuid:number, callback:string)
+
* ''tnuid'': number
−
|
+
* ''per_id'': number
−
|
+
* ''pnid'': number
−
|-
+
* ''showChildren'': string
−
|getTaxonNewTaxaByPub(tnuid:number, validOnly:<nowiki>Y|N</nowiki>, callback:string)
+
* ''format'': string
−
|
+
* ''key'': string
−
|
+
 
−
|-
+
===== Return =====
−
|getTaxonNewTaxaByYear(tnuid:number, validOnly:<nowiki>Y|N</nowiki>, callback:string)
+
* ''locInfo'': loc_info with below extensions
−
|
+
** ''hier'': array of place
−
|
+
** ''cuids'': array of cuid
−
|-
+
 
−
|getTaxonStatsForYear(tnuid:number, stats_year:number, callback:string)
+
===== Example =====
−
|
+
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getUnvLocalityInfo?loc_id=1&tnuid=30148&per_id=1&pnid=1&showChildren=Y&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
−
|
+
 
−
|}
+
=== Place / Geopolitical Entity ===
 +
==== getPlaceInfo ====
 +
===== Description =====
 +
Get basic place information including the place hierarchy, number of specimens, and number of species.
 +
===== Parameters =====
 +
* ''place_id'': number
 +
* ''format'': string
 +
* ''key'': string
 +
 
 +
===== Return =====
 +
* ''place_info'': place with below extension
 +
** ''hier'': array of place
 +
** ''num_species'': number
 +
** ''num_spms'': number
 +
 
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getPlaceInfo?place_id=1&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 
 +
==== getSubdivisions ====
 +
===== Description =====
 +
Get smaller levels of divisions for a selected place.
 +
===== Parameters =====
 +
* ''place_id'': number
 +
* ''format'': string
 +
* ''key'': string
 +
 
 +
===== Return =====
 +
* ''subdivs'': array of place
 +
 
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getSubdivisions?place_id=1&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 
 +
==== getGeoTaxa ====
 +
===== Description =====
 +
Get taxonomic information from a specified place.
 +
 
 +
===== Parameters =====
 +
* ''place_id'': number
 +
* ''format'': string
 +
* ''key'': string
 +
 
 +
===== Return =====
 +
* ''taxa'': array of taxon_basic with below extensions
 +
** ''valid_taxon'': taxon_basic (only present when defined)
 +
** ''hier'': taxon_hierarchy
 +
** ''count'': number
 +
** ''rank'': string
 +
 
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getGeoTaxa?place_id=1&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 
 +
==== getGeoCollTrips ====
 +
===== Description =====
 +
Get collecting trips info for a specified place.
 +
===== Parameters =====
 +
* ''place_id'': number
 +
* ''format'': string
 +
* ''key'': string
 +
 
 +
===== Return =====
 +
* ''coll_trips'': array of loc_basic and collector.
 +
 
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getGeoCollTrips?place_id=1&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 
 +
==== getGeoCollTrips2 ====
 +
===== Description =====
 +
Get collecting trips and taxa info for a specified place.
 +
 
 +
===== Parameters =====
 +
* ''place_id'': number
 +
* ''format'': string
 +
* ''key'': string
 +
 
 +
===== Return =====
 +
* ''coll_trips'': array of taxon_basic, collection, collector and loc_basic with below extension
 +
** ''valid_taxon'': taxon_basic (only present when defined)
 +
 
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getGeoCollTrips2?place_id=1&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 
 +
==== getGeoInsts ====
 +
===== Description =====
 +
Get institutions from a selected place.
 +
===== Parameters =====
 +
* ''place_id'': number
 +
* ''format'': string
 +
* ''key'': string
 +
 
 +
===== Return =====
 +
* ''collections'': array of collection_extended
 +
 
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getGeoInsts?place_id=1&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 
 +
=== Literature ===
 +
==== getLitReference ====
 +
===== Description =====
 +
Get the reference for a selected publication.
 +
===== Parameters =====
 +
* ''pub_id'': number
 +
* ''format'': string
 +
* ''key'': string
 +
 
 +
===== Return =====
 +
* ''pub_ref'': literature_extended
 +
 
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getLitReference?pub_id=419&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 
 +
==== getLitParts ====
 +
===== Description =====
 +
Get parts of the selected publication, such as pages, pdf urls, chapters, titles, authors, and more.
 +
===== Parameters =====
 +
* ''pub_id'': number
 +
* ''format'': string
 +
* ''key'': string
 +
 
 +
===== Return =====
 +
* ''pub_parts'': array of literature_extended
 +
 
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getLitParts?pub_id=20239&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 
 +
==== getPubTaxonCitation ====
 +
===== Description =====
 +
Get cited taxon information from a selected publication.
 +
===== Parameters =====
 +
* ''pub_id'': number
 +
* ''format'': string
 +
* ''key'': string
 +
 
 +
===== Return =====
 +
* ''pub_cits'': array of pub_basic and taxon_basic with below extensions
 +
** ''tnucid'': number
 +
** ''rank'': string
 +
* ''public'': string
 +
* ''author'': string
 +
 
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getPubTaxonCitation?pub_id=419&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 
 +
==== getPubAssocCitation ====
 +
===== Description =====
 +
 
 +
===== Parameters =====
 +
* ''pub_id'': number
 +
* ''format'': string
 +
* ''key'': string
 +
 
 +
===== Return =====
 +
* ''assoc_cits'': array of ..
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getPubAssocCitation?pub_id=23683&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 
 +
=== Journal ===
 +
==== getJournalInfo ====
 +
===== Description =====
 +
 
 +
===== Parameters =====
 +
* ''jrnl_id'': number
 +
* ''format'': string
 +
* ''key'': string
 +
 
 +
===== Return =====
 +
* ''journal_info'': array of below elements
 +
** ''name'': string
 +
** ''url'': string
 +
** ''is_public'': string
 +
** ''copyright_holder'': string
 +
** ''num_articles'': number
 +
** ''num_pdfs'': number
 +
** ''num_taxa'': number
 +
** ''last_article_time'': string
 +
 
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getJournalInfo?jrnl_id=1&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 
 +
==== getJournalPubs ====
 +
===== Description =====
 +
 
 +
===== Parameters =====
 +
* ''jrnl_id'': number
 +
* ''format'': string
 +
* ''key'': string
 +
 
 +
===== Return =====
 +
* ''pubs'': array of literature_extended
 +
 
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getJournalPubs?jrnl_id=1&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 
 +
==== getJournalTaxa ====
 +
===== Description =====
 +
 
 +
===== Parameters =====
 +
* ''jrnl_id'': number
 +
* ''format'': string
 +
* ''key'': string
 +
 
 +
===== Return =====
 +
* ''taxa'': array of taxon_basic
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getJournalTaxa?jrnl_id=1&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 
 +
=== Institution ===
 +
==== getCollectionInfo ====
 +
===== Description =====
 +
 
 +
===== Parameters =====
 +
* ''inst_id'': number
 +
* ''format'': string
 +
* ''key'': string
 +
 
 +
===== Return =====
 +
* ''collection_info'': array of collection_extended with below extensions
 +
** ''vouchered'': boolean
 +
** ''num_prim_types'': number
 +
** ''num_sec_types'': number
 +
** ''num_species'': number  
 +
**  ''last_spm_time'': string
 +
** ''oldest_spm'': array of below elements
 +
*** ''cuid'': string
 +
*** ''coll_date'': string
 +
 
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getCollectionInfo?inst_id=21&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 
 +
==== getPrimaryTypes ====
 +
===== Description =====
 +
Get specimen of which the description of a new species is based.
 +
===== Parameters =====
 +
* ''inst_id'': number
 +
* ''format'': string
 +
* ''key'': string
 +
 
 +
===== Return =====
 +
* ''types'': array of type
 +
 
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getPrimaryTypes?inst_id=6&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 
 +
==== getSecondaryTypes ====
 +
===== Description =====
 +
Get specimen that are occurrences of a specific species, but not a primary type.
 +
===== Parameters =====
 +
* ''inst_id'': number
 +
* ''format'': string
 +
* ''key'': string
 +
 
 +
===== Return =====
 +
* ''types'': array of type
 +
 
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getSecondaryTypes?inst_id=6&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 
 +
==== getInstTaxa ====
 +
===== Description =====
 +
Get taxa and related taxonomic information from a selected institution.
 +
===== Parameters =====
 +
* ''inst_id'': number
 +
* ''format'': string
 +
* ''key'': string
 +
 
 +
===== Return =====
 +
* ''taxa'': array of taxon_extended with below extension
 +
** ''hier'': taxon_hierarchy
 +
 
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getInstTaxa?inst_id=21&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 
 +
==== getInstCollTrips2 ====
 +
===== Description =====
 +
Get collecting trip events and the specimen collected for a selected institution.
 +
===== Parameters =====
 +
* ''inst_id'': number
 +
* ''format'': string
 +
* ''key'': string
 +
 
 +
===== Return =====
 +
* ''coll_trips'': array of taxon_basic, collection, collector, and loc_basic.
 +
 
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getInstCollTrips2?inst_id=21&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 
 +
==== getInstPubs ====
 +
===== Description =====
 +
Get published literature from a selected institution.
 +
===== Parameters =====
 +
* ''inst_id'': number
 +
* ''format'': string
 +
* ''key'': string
 +
 
 +
===== Return =====
 +
* ''pubs'': array of literature_extended
  
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getInstPubs?inst_id=1&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
  
−
==== Occurrence / Specimen ====
+
=== Text Search ===
−
{|
+
==== getSearchResults ====
−
! align="left"| Method
+
===== Description =====
−
! align="left"| Return
+
Get database results from a text keyword search.
−
! align="left"| Description
+
===== Parameters =====
−
|-
+
* ''name'': string
−
|getSpmInfo(cuid:string, callback:string)
+
* ''limit'': number
−
|
+
* ''categoryLimit'': string
−
|
+
* ''format'': string
−
|-
+
* ''key'': string
−
|getSpmsInfo(cuids:array of string, callback:string)
 
−
|
 
−
|
 
−
|}
 
  
 +
===== Return =====
 +
* ''taxon_results'': array of below extensions
 +
** ''taxa'': array of taxon_extended with below extension
 +
*** ''lsid'': number
 +
** ''count'': number
 +
* ''cuid_results'': array of below extensions
 +
** ''cuids'': array of cuids
 +
** ''count'': number
 +
* ''agent_results'': array of below extensions
 +
** ''agents'': array of below extensions
 +
*** ''type'': string
 +
*** ''id'': number
 +
*** ''name'': string
 +
*** ''inst'': string
 +
** ''count'': number
 +
* ''inst_results'': array of below extensions
 +
** ''inst'': array of collection_extended
 +
** ''count'': number
 +
* ''place_results'': array of below extensions
 +
** ''places'': array of place with below extension
 +
*** ''hier'': array of place
 +
** ''count'': number
 +
* ''journal_results'': array of below extensions
 +
** ''journals'': array of below extensions
 +
*** ''name'': string
 +
*** ''id'': number
 +
** ''count'': number
  
−
==== Locality ====
+
===== Example =====
−
{|
+
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getSearchResults?name=%OSU%&limit=20&categoryLimit=&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
−
! align="left"| Method
 
−
! align="left"| Return
 
−
! align="left"| Description
 
−
|-
 
−
|getLocalityInfo(locID:number, tnuid:number, inst_id:number, per_id:number, pnid:number, showChildren:<nowiki>Y|N</nowiki>, completeSpmInfo:<nowiki>Y|N</nowiki>, callback:string)
 
−
|
 
−
|
 
−
|}
 
  
 +
==== getTaxaFromText ====
 +
===== Description =====
 +
Get taxa results from a selected search keyword.
 +
===== Parameters =====
 +
* ''name'': string
 +
* ''limit'': number
 +
* ''nameOnly'': string
 +
* ''format'': string
 +
* ''key'': string
  
−
==== Place / Geopolitical Entity ====
+
===== Return =====
−
{|
+
* ''taxa'': array of taxon_extended with below extensions
−
! align="left"| Method
+
** ''lsid'': number
−
! align="left"| Return
+
* ''count'': number
−
! align="left"| Description
 
−
|-
 
−
|getPlaceInfo(place_id:number, callback:string)
 
−
|
 
−
|
 
−
|-
 
−
|getSubdivisions(place_id:number, callback:string)
 
−
|
 
−
|
 
−
|-
 
−
|getGeoTaxa(place_id:number, callback:string)
 
−
|
 
−
|
 
−
|-
 
−
|getGeoCollTrips(place_id:number, callback:string)
 
−
|
 
−
|
 
−
|-
 
−
|getGeoCollTrips2(place_id:number, callback:string)
 
−
|
 
−
|
 
−
|-
 
−
|getGeoInsts(place_id:number, callback:string)
 
−
|
 
−
|
 
−
|}
 
  
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getTaxaFromText?name=Heptascelio+striatosternus&limit=10&nameOnly=N&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
  
−
==== Literature ====
+
==== getCuidsFromText ====
−
{|
+
===== Description =====
−
! align="left"| Method
+
Get occurrence results from a selected search keyword.
−
! align="left"| Return
+
===== Parameters =====
−
! align="left"| Description
+
* ''name'': string
−
|-
+
* ''limit'': number
−
|getLitReference(pub_id:number, callback:string)
+
* ''format'': string
−
|
+
* ''key'': string
−
|
 
−
|-
 
−
|getLitParts(pub_id:number, callback:string)
 
−
|
 
−
|
 
−
|-
 
−
|getPubTaxonCitation(pub_id:number, callback:string)
 
−
|
 
−
|
 
−
|-
 
−
|getPubAssocCitation(pub_id:number, callback:string)
 
−
|
 
−
|
 
−
|}
 
  
 +
===== Return =====
 +
* ''cuids'': array of cuid
 +
* ''count'': number
  
−
==== Journal ====
+
===== Example =====
−
{|
+
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getCuidsFromText?name=%OSUC%&limit=10&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
−
! align="left"| Method
 
−
! align="left"| Return
 
−
! align="left"| Description
 
−
|-
 
−
|getJournalInfo(jrnl_id:number, callback:string)
 
−
|
 
−
|
 
−
|-
 
−
|getJournalPubs(jrnl_id:number, callback:string)
 
−
|
 
−
|
 
−
|-
 
−
|getJournalTaxa(jrnl_id:number, callback:string)
 
−
|
 
−
|
 
−
|}
 
  
 +
==== getAgentsFromText ====
 +
===== Description =====
 +
Get agent (person and/or party) results from a selected search keyword.
 +
===== Parameters =====
 +
* ''name'': string
 +
* ''limit'': number
 +
* ''includeParty'': string
 +
* ''format'': string
 +
* ''key'': string
  
−
==== Institution ====
+
===== Return =====
−
{|
+
* ''agents'': array of below elements
−
! align="left"| Method
+
** ''id'': number
−
! align="left"| Return
+
** ''type'': string
−
! align="left"| Description
+
** ''name'': string
−
|-
+
** ''inst'': string
−
|getCollectionInfo(inst_id:number, callback:string)
+
* ''count'': number
−
|
 
−
|
 
−
|-
 
−
|getPrimaryTypes(inst_id:number, callback:string)
 
−
|
 
−
|
 
−
|-
 
−
|getSecondaryTypes(inst_id:number, callback:string)
 
−
|
 
−
|
 
−
|-
 
−
|getInstTaxa(inst_id:number, callback:string)
 
−
|
 
−
|
 
−
|-
 
−
|getInstCollTrips2(inst_id:number, callback:string)
 
−
|
 
−
|
 
−
|-
 
−
|getInstPubs(inst_id:number, callback:string)
 
−
|
 
−
|
 
−
|}
 
  
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getAgentsFromText?name=%Johnson,%20N.%20F.%&limit=10&includeParty=Y&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
  
−
==== Unvouchered Record ====
+
==== getInstFromText ====
−
{|
+
===== Description =====
−
! align="left"| Method
+
Get institution/collection results from a selected search keyword(s).
−
! align="left"| Return
+
===== Parameters =====
−
! align="left"| Description
+
* ''name'': string
−
|-
+
* ''limit'': number
−
|getUnvoucheredRecord(unv_id:number, callback:string)
+
* ''format'': string
−
|
+
* ''key'': string
−
|
+
 
−
|-
+
===== Return =====
−
|getUnvoucheredRecords(tnuid:number, showChildren:<nowiki>Y|N</nowiki>, pnids:array of number, callback:string)
+
* ''inst'': array of collection_extended
−
|
+
* ''count'': number
−
|
+
 
−
|-
+
===== Example =====
−
|getUnvoucheredRecords(tnuids:array of number, pnids:array of number, callback:string)
+
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getInstFromText?name=Hymenoptera&limit=10&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
−
|
+
 
−
|
+
==== getJournalsFromText ====
−
|-
+
===== Description =====
−
|getUnvLocalityInfo(locID:number, tnuid:number, per_id:number, pnid:number, showChildren:<nowiki>Y|N</nowiki>, callback:string)
+
Get journal results from a selected search keyword(s).
−
|
+
===== Parameters =====
−
|
+
* ''name'': string
−
|}
+
* ''limit'': number
 +
* ''format'': string
 +
* ''key'': string
 +
 
 +
===== Return =====
 +
* ''journals'': array of below elements
 +
** ''name'': string
 +
** ''id'': number
 +
* ''count'': number
 +
 
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getJournalsFromText?name=Insect&limit=10&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 
 +
==== getOrgsFromText ====
 +
===== Description =====
 +
Get organization results for a selected search keyword(s).
 +
===== Parameters =====
 +
* ''name'': string
 +
* ''limit'': number
 +
* ''format'': string
 +
* ''key'': string
 +
 
 +
===== Return =====
 +
* ''orgs'': array of below elements
 +
** ''name'': string
 +
** ''id'': number
 +
* ''count'': number
 +
 
 +
===== Example =====
 +
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getOrgsFromText?name=%Geo%&limit=10&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
 +
 
 +
==== getPlacesFromText ====
 +
===== Description =====
  
 +
===== Parameters =====
 +
* ''name'': string
 +
* ''limit'': number
 +
* ''format'': string
 +
* ''key'': string
  
−
==== Text Search ====
+
===== Return =====
−
{|
+
* ''places'': array of place with below extension
−
! align="left"| Method
+
** ''hier'': array of place
−
! align="left"| Return
+
* ''count'': number
−
! align="left"| Description
 
−
|-
 
−
|getSearchResults(name:string, limit:number, categoryLimit:string, callback:string)
 
−
|
 
−
|
 
−
|-
 
−
|getTaxaFromText(name:string, limit:number, nameOnly:<nowiki>Y|N</nowiki>, callback:string)
 
−
|
 
−
|
 
−
|-
 
−
|getCuidsFromText(name:string, limit:number, callback:string)
 
−
|
 
−
|
 
−
|-
 
−
|getAgentsFromText(name:string, limit:number, includeParty:<nowiki>Y|N</nowiki>, callback:string)
 
−
|
 
−
|
 
−
|-
 
−
|getInstFromText(name:string, limit:number, callback:string)
 
−
|
 
−
|
 
−
|-
 
−
|getJournalsFromText(name:string, limit:number, callback:string)
 
−
|
 
−
|
 
−
|-
 
−
|getOrgsFromText(name:string, limit:number, callback:string)
 
−
|
 
−
|
 
−
|-
 
−
|getPlacesFromText(name:string, limit:number, callback:string)
 
−
|
 
−
|
 
−
|-
 
−
|getLocalitiesFromText(name:string, limit:number, callback:string)
 
−
|
 
−
|
 
−
|-
 
−
|getCollMethodsFromText(name:string, limit:number, callback:string)
 
−
|
 
−
|
 
−
|}
 
  
−
=== Data Type Glossary ===
+
===== Example =====
−
[OJ_Break API Data Type Glossary]
+
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getPlacesFromText?name=Guyana&limit=10&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
  
−
==== Classes ====
+
==== getLocalitiesFromText ====
−
===== author_basic =====
+
===== Description =====
−
====== author_id ======
 
−
String - The family name of the author.
 
−
====== last_name ======
 
−
String - The family name of the author.
 
−
====== initials ======
 
−
String - The initials for the given name of an author.
 
−
====== generation ======
 
−
String - The generational designation (Jr., III, etc.) for an author.
 
−
====== name_order ======
 
−
String - An indicator specifying whether an author's name should be formatted according to western (W) or eastern (E) conventions.
 
  
−
===== contrib_literature_basic (extension of literature_basic) =====
+
===== Parameters =====
−
====== contrib_pub_id ======
+
* ''name'': string
−
pub_id - ''pub_id'' element for the contribution to the underlying publication (only present for contributions)
+
* ''limit'': number
−
====== contrib_author_base_id ======
+
* ''format'': string
−
author_id - ''author_id'' element for the contributing author(s) (only present for contributions)
+
* ''key'': string
−
====== contrib_author ======
 
−
String - The comma separated list of contributing authors' family names (only present for contributions).
 
−
====== contrib_author_extended ======
 
−
Array of author_basic - array of ''author_basic'' elements for the contribution (only present for contributions)
 
−
====== contrib_title ======
 
−
String - The title for the contribution (only present for contributions).
 
  
−
===== literature_basic =====
+
===== Return =====
−
====== pub_id ======
+
* ''locs'': array of below elements
−
pub_id - ''pub_id'' element for the publication
+
** ''name'': string
−
====== type ======
+
** ''id'': number
−
String - The type of format in which this piece of literature was published.
+
* ''count'': number
−
====== author_base_id ======
 
−
author_id - ''author_id'' element for the author(s)
 
−
====== author ======
 
−
String - The comma separated list of authors' family names.
 
−
====== author_extended ======
 
−
Array of author_basic - array of ''author_basic'' elements for the publication
 
−
====== title ======
 
−
String - The title of the publication.
 
−
====== year ======
 
−
String - The year of publication.
 
−
====== month ======
 
−
String - The month of publication.
 
−
====== doi ======
 
−
String - The digital object identifier (DOI) assigned to a publication.
 
−
====== journal ======
 
−
String - The journal in which the article was published (only present for articles and bulletins)
 
−
====== journal_id ======
 
−
jrnl_id - ''jrnl_id'' element (only present for articles and bulletins)
 
−
====== series ======
 
−
String - The series of a journal in which an article was published (only present for articles and bulletins)
 
−
====== volume ======
 
−
String - The volume of a journal in which an article was published (only present for articles and bulletins)
 
−
====== vol_num ======
 
−
String - The part (number) within a volume of a journal in which an article was published (only present for articles and bulletins)
 
−
====== publisher ======
 
−
String - The organization that published the book (only present for books and chapters)
 
−
====== city ======
 
−
String - The city in which the book was published (only present for books and chapters)
 
−
====== start_page ======
 
−
String - The starting page of a publication (only present for articles and chapters)
 
−
====== end_page ======
 
−
String - The ending page of a publication (only present for articles and chapters)
 
−
====== num_pages ======
 
−
String - The total number of pages of a publication (only present for books, chapters, and bulletins)
 
−
====== chap_title ======
 
−
String - The title of the chapter (only present for chapters).
 
−
====== chap_num ======
 
−
String - The designation for a chapter within a book (only present for chapters).
 
−
====== chap_author ======
 
−
String - The comma separated list of chapter authors' family names (only present for chapters).
 
−
====== chap_author_extended ======
 
−
Array of author_basic - array of ''author_basic'' elements for the chapter (only present for chapters)
 
−
====== book_id ======
 
−
pub_id - ''pub_id'' element of the book for a chapter (only present for chapters)
 
  
−
===== taxon_basic =====
+
===== Example =====
−
====== tnuid ======
+
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getLocalitiesFromText?name=Guyana&limit=10&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
−
tnuid - ''tnuid'' element
 
−
====== taxon ======
 
−
taxon - ''taxon'' element
 
−
====== author ======
 
−
author - ''author'' element
 
  
−
===== taxon_hierarchy =====
+
==== getCollMethodsFromText ====
−
====== Kingdom ======
+
===== Description =====
−
taxon_hier_unit - ''taxon_hier_unit'' class
 
−
====== Phylum ======
 
−
taxon_hier_unit - ''taxon_hier_unit'' class (not present if of lower rank or unspecified within the specified taxon)
 
−
====== Subphylum ======
 
−
taxon_hier_unit - ''taxon_hier_unit'' class (not present if of lower rank or unspecified within the specified taxon)
 
−
====== Class ======
 
−
taxon_hier_unit - ''taxon_hier_unit'' class (not present if of lower rank or unspecified within the specified taxon)
 
−
====== Subclass ======
 
−
taxon_hier_unit - ''taxon_hier_unit'' class (not present if of lower rank or unspecified within the specified taxon)
 
−
====== Infraclass ======
 
−
taxon_hier_unit - ''taxon_hier_unit'' class (not present if of lower rank or unspecified within the specified taxon)
 
−
====== Order ======
 
−
taxon_hier_unit - ''taxon_hier_unit'' class (not present if of lower rank or unspecified within the specified taxon)
 
−
====== Suborder ======
 
−
taxon_hier_unit - ''taxon_hier_unit'' class (not present if of lower rank or unspecified within the specified taxon)
 
−
====== Infraorder ======
 
−
taxon_hier_unit - ''taxon_hier_unit'' class (not present if of lower rank or unspecified within the specified taxon)
 
−
====== Superfamily ======
 
−
taxon_hier_unit - ''taxon_hier_unit'' class (not present if of lower rank or unspecified within the specified taxon)
 
−
====== Family ======
 
−
taxon_hier_unit - ''taxon_hier_unit'' class (not present if of lower rank or unspecified within the specified taxon)
 
−
====== Subfamily ======
 
−
taxon_hier_unit - ''taxon_hier_unit'' class (not present if of lower rank or unspecified within the specified taxon)
 
−
====== Tribe ======
 
−
taxon_hier_unit - ''taxon_hier_unit'' class (not present if of lower rank or unspecified within the specified taxon)
 
−
====== Genus ======
 
−
taxon_hier_unit - ''taxon_hier_unit'' class (not present if of lower rank or unspecified within the specified taxon)
 
−
====== Species ======
 
−
taxon_hier_unit - ''taxon_hier_unit'' class (not present if of lower rank or unspecified within the specified taxon)
 
−
====== Subspecies ======
 
−
taxon_hier_unit - ''taxon_hier_unit'' class (not present if of lower rank or unspecified within the specified taxon)
 
  
−
===== taxon_hier_unit (extension of taxon_basic) =====
+
===== Parameters =====
−
====== next ======
+
* ''name'': string
−
String - The rank (key) of the next taxon in the taxonomic hierarchy. This value is ''null'' on the last taxon in the hierarchy.
+
* ''limit'': number
 +
* ''format'': string
 +
* ''key'': string
  
−
===== taxon_source =====
+
===== Return =====
−
====== id ======
+
* ''coll_methods'': array of below elements
−
String - The source identifier which uniquely identifies a taxonomic source. Will be empty when not defined.
+
** ''name'': string
−
====== name ======
+
** ''id'': number
−
String - The name for the taxonomic source.
+
* ''count'': number
−
====== logo ======
 
−
URL - A URL for the logo image for the taxonomic source.
 
−
====== url ======
 
−
URL - A URL to the taxonomic source resource.
 
−
====== query ======
 
−
URL - A URL to the taxonomic source resource for the specified taxon.
 
  
−
===== taxon_stats =====
+
===== Example =====
−
====== included ======
+
https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getCollMethodsFromText?name=reared&limit=10&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC
−
String - The number of taxa included within this taxon.
 
−
====== synonym ======
 
−
String - The number of taxa synonymous with this taxon.
 
−
====== maps ======
 
−
String - The number of occurrence records identified to this taxon.
 
−
====== lits ======
 
−
String - The number of literature citations to this taxon.
 
−
====== lits_syns ======
 
−
String - The number of literature citations to this taxon and its synonyms.
 
−
====== assocs ======
 
−
String - The number of number of distinct biological associations for this taxon.
 
−
====== habitats ======
 
−
String - The number of number of distinct habitats for this taxon.
 
−
====== insts ======
 
−
String - The number of collections with occurrence records for this taxon.
 
−
====== type_syns ======
 
−
String - The number of type specimens for this taxon and its synonyms.
 
  
−
==== Elements ====
+
== Data Type Glossary ==
−
===== author =====
+
[[OJ_Break API Data Type Glossary]]
−
String - The author(s) of a taxon with parenthesis surrounding the name of the author(s) if necessary.
 
−
===== author_id =====
 
−
Number - The author identifier which uniquely identifies an author or group of authors.
 
−
===== fossil =====
 
−
String - A modified boolean string, either Y, N or B, representing whether a taxon name is a extinct fossil, exclusively extant, or present today and in fossils.
 
−
===== inst_id =====
 
−
Number - The collection (or institution) identifier which uniquely identifies a collection, vouchered or unvouchered. A value of ''0'' indicates that all of the collections are used.
 
−
===== jrnl_id =====
 
−
Number - The journal identifier which uniquely identifies a journal.
 
−
===== pub_id =====
 
−
Number - The publication identifier which uniquely identifies a publication.
 
−
===== rank =====
 
−
String - The taxonomic (hierarchical) rank of a taxon name.
 
−
===== rel_type =====
 
−
String - The taxonomic (hierarchical) relationship between the taxonomic concept indicated by the taxon name and its parent taxonomic concept. Can be ''Member'', ''Junior synonym'', etc.
 
−
===== status =====
 
−
String - The nomenclatural status of a taxon name using a formalized vocabulary.
 
−
===== taxon =====
 
−
String - A taxon name string.
 
−
===== tnid =====
 
−
Number - The taxon name identifier which uniquely identifies a taxon name string.
 
−
===== tnuid =====
 
−
Number - The taxon name use identifier which uniquely identifies a taxon.
 
−
===== valid =====
 
−
String - A ''Valid'' or ''Invalid'' string representing the validity of a taxon name using subjective interpretations if warranted.
 
  
  
 
[[Category:OJ_Break API]]
 
[[Category:OJ_Break API]]
 +
[[Category:APIs]]

Latest revision as of 14:57, 9 July 2018

Introduction

OJ_Break is the name of the xBio:D RESTful API service to facilitate discovery of data within the xBio:D database. The API can respond with JavaScript Object Notation (JSON), XML, or JSON with padding (JSONP) and accepts HTTP GET and POST requests indiscriminately. The backend of the API is written in Oracle's PL/SQL database language, which is fast but often inflexible, while a Python presentation layer mitigates request handling and authentication.


The reference for version 2 of the API can be found here: OJ_Break_Version_2_API_Reference


Contents

API Information and Access

This page specifies the methods and data defined by OJ_Break Version 1. Using the OJ_Break Version 1 API requires calling methods with corresponding, method specific parameters (found in this page) and a few other required parameters. These include specifying a return format and an API access key. 

   Example: https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getTaxonStats?tnuid=30148&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

To read more about using the OJ_Break Version 1 API, go to OJ_Break API Access.

Procedural Reference

Agent

getCollectorInfo

Description
Parameters
  • collector_id: number
  • format: string
  • key: string
Return
  • collector_info: array of author_info
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getCollectorInfo?collector_id=2&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getAuthorPubs

Description
Parameters
  • author_id: number
  • format: string
  • key: string
Return
  • pubs: array of literature_extended
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getAuthorPubs?author_id=2&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getCollTrips2

Description
Parameters
  • collector_id: number
  • format: string
  • key: string
Return
  • coll_trips: array of collection_basic, taxon_basic, loc_coords, and collector.
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getCollTrips2?collector_id=2&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getAuthorTaxa

Description
Parameters
  • author_id: number
  • format: string
  • key: string
Return

taxa: array of taxon_basic

Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getAuthorTaxa?author_id=2&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

Taxon

getTaxonStats

Description

Get some basic taxonomic statistics for a taxon from a tnuid.

Parameters
  • tnuid: number
  • format: string
  • key: string
Return
  • taxon: string
  • author: string
  • stats: taxon_stats
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getTaxonStats?tnuid=30148&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getTaxonInfo

Description

Get some basic taxonomic information for a taxon from a tnuid.

Parameters
  • tnuid: number
  • inst_id: number
  • format: string
  • key: string
Return
  • taxon_rel_extended class with below extensions
  • valid_taxon: taxon_basic (only present when defined)
  • parent_taxon: taxon_basic
  • hier: taxon_hierarchy
  • source: taxon_source
  • common_names: array of common_name
  • orig_desc: contrib_literature_basic (only present when defined)
  • stats: taxon_info_stats
  • contribs: array of contribution
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getTaxonInfo?tnuid=30148&inst_id=0&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getTaxonHierarchy

Description

Get the taxonomic hierarachy in which a taxon is at the terminal node from a tnuid.

Parameters
  • tnuid: number
  • format: string
  • key: string
Return
  • taxon: string
  • author: string
  • hier: taxon_hierarchy
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getTaxonHierarchy?tnuid=30148&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getIncludedTaxa

Description

Get the taxa that are directly included within a taxon but not synonymous with it.

Parameters
  • tnuid: number
  • inst_id: number
  • showSyns: boolean_flag
  • showFossils: boolean_flag
  • types_only: boolean_flag
  • show_num_spms: boolean_flag
  • format: string
  • key: string
Return
  • tnuid: number
  • parent_tnuid: number
  • includedTaxa: array of taxon_extended
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getIncludedTaxa?tnuid=491&inst_id=0&showSyns=Y&showFossils=Y&types_only=N&show_num_spms=N&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getTaxonSynonyms

Description

Get the taxa that are objectively or subjectively synonymous with a taxon.

Parameters
  • tnuid: number
  • showFossils: boolean_flag
  • format: string
  • key: string
Return
  • synonyms: array of taxon_rel_extended
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getTaxonSynonyms?tnuid=30148&showFossils=Y&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getLocalities

Description

Get the localities from vouchered and unvouchered records for a taxon.

Parameters
  • tnuid: number
  • inst_id: number
  • precDecimals: number
  • showChildren: boolean_flag
  • format: string
  • key: string
Return
  • localities: array of loc_coords
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getLocalities?tnuid=30148&inst_id=0&precDecimals=4&showChildren=Y&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getLocalities

Description

Get the localities within geopolitical divisions from vouchered and unvouchered records for a taxon.

Parameters
  • tnuid: number
  • pnids: array of pnid
  • inst_id: number
  • precDecimals: number
  • showChildren: boolean_flag
  • format: string
  • key: string
Return
  • localities: array of loc_coords
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getLocalities?tnuid=30148&pnids=5816,5735&inst_id=0&precDecimals=4&showChildren=Y&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getCuids

Description

Get the occurrence identifiers (collecting unit IDs) for a taxon.

Parameters
  • tnuid: number
  • showChildren: boolean_flag
  • inst_id: number
  • pnids: array of pnid
  • format: string
  • key: string
Return
  • cuids: array of cuid
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getCuids?tnuid=30148&showChildren=Y&inst_id=1&pnids=&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getCuids

Description

Get the occurrence identifiers (collecting unit IDs) for selected taxa.

Parameters
  • tnuids: array of tnuid
  • pnids: array of pnid
  • format: string
  • key: string
Return
  • cuids: array of cuid
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getCuids?tnuids=30148,491&pnids=5816,5735&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getTypes

Description

Gets information and specimen types for a specified taxon.

Parameters
  • tnuid: number
  • showSyns: boolean_flag
  • inst_id: number
  • primary_only: boolean_flag
  • taxon_author_search: string
  • offset: number
  • limit: number
  • format: string
  • key: string
Return
  • num_records: number
  • types: array of type_extended
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getTypes?tnuid=434&showSyns=F&inst_id=1&primary_only=Y&taxon_author_search=&offset=1&limit=10&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getInsts

Description

Gets institutions which hold specimens for a selected taxon.

Parameters
  • tnuid: number
  • format: string
  • key: string
Return
  • collections: array of collection_extended
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getInsts?tnuid=30148&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getTaxonLiterature (deprecated)

Description

Deprecated. Use getTaxonLit instead

Parameters
  • tnuid: number
  • showSyns: string
  • format: string
  • key: string
Return
  • lit: pubs
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getTaxonLiterature?tnuid=30148&showSyns=Y&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getTaxonLit

Description

Preferred. Get literature for a selected taxon.

Parameters
  • tnuid: number
  • showSyns: boolean_flag
  • format: string
  • key: string
Return
  • pubs: array of pub_extended
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getTaxonLit?tnuid=30148&showSyns=Y&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getAssociations

Description

Get evolutionary relationships for a certain taxon.

Parameters
  • tnuid: number
  • rank_grouping: string
  • format: string
  • key: string
Return
  • associations: array of association
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getAssociations?tnuid=491&rank_grouping=&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getHabitats

Description

Get descriptions of the habitats that a selected specimen inhabits.

Parameters
  • tnuid: number
  • format: string
  • key: string
Return
  • habitats: array of habitat
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getHabitats?tnuid=30148&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getTaxonMedia

Description

Get images, videos, or sound clips of a selected taxon.

Parameters
  • tnuid: number
  • format: string
  • key: string
Return
  • media: array of media_basic
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getTaxonMedia?tnuid=30148&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getTaxonBreakdown

Description

Get count of genders and total specimen included in the current rank.

Parameters
  • tnuid: number
  • format: string
  • key: string
Return
  • taxa: array of taxon_basic with below extension
    • count: number
  • sex: array of spm_sex
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getTaxonBreakdown?tnuid=491&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getTaxonPhenology

Description

Get taxon specimens by date.

Parameters
  • tnuid: number
  • format: string
  • key: string
Return
  • spms: array of below elements
    • date: string
    • sort_date: string
    • cuid: string
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getTaxonPhenology?tnuid=30148&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getTaxonNewTaxaByPub

Description

Get count of new specimens for a specific taxon by publication.

Parameters
  • tnuid: number
  • validOnly: boolean_flag
  • format: string
  • key: string
Return
  • pubs: array of literature_extended with below extension
    • taxa_num: string
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getTaxonNewTaxaByPub?tnuid=491&validOnly=Y&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getTaxonNewTaxaByYear

Description

Get count of new specimens for a specific taxon by year.

Parameters
  • tnuid: number
  • validOnly: string
  • format: string
  • key: string
Return
  • years: array of below elements
    • taxa_num: string
    • year: string
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getTaxonNewTaxaByYear?tnuid=52&validOnly=Y&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getTaxonStatsForYear

Description

Get stats, such as image count, new genera introduced, new specimen introduced, and more by year for a selected taxon.

Parameters
  • tnuid: number
  • stats_year: number
  • format: string
  • key: string
Return
  • stats: array of below elements
    • new_spm_num: number
    • all_spm_num: number
    • new_taxa_spm_num: array of number
    • all_taxa_spm_num: array of number
    • new_images_num: number
    • all_images_num: number
    • spm_years: array of string
    • images_years: array of string
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getTaxonStatsForYear?tnuid=30148&stats_year=2014&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

Occurrence

Specimen Record

getSpmInfo
Description

Get info for a specific specimen occurrence.

Parameters
  • cuid: string
  • format: string
  • key: string
Return
  • spmInfo: record_vouchered
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getSpmInfo?cuid=OSUC+59557&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getSpmsInfo
Description

Get info for multiple specimen occurrences.

Parameters
  • cuids: array of string
  • format: string
  • key: string
Return
  • spmsInfo: array of record_vouchered
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getSpmsInfo?cuids=OSUC+59557,OSUC+56308&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

Unvouchered Record

getUnvoucheredRecord
Description

Get specimen record information for a selected unvouchered specimen.

Parameters
  • unv_id: number
  • format: string
  • key: string
Return
  • unvoucheredRecord: record_unvouchered
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getUnvoucheredRecord?unv_id=1&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getUnvoucheredRecords
Description

Get unvouchered specimen records for a selected taxon and place.

Parameters
  • tnuid: number
  • showChildren: string
  • pnids: array of number
  • format: string
  • key: string
Return
  • unvoucheredRecords: array of record_unvouchered
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getUnvoucheredRecords?tnuid=44&showChildren=Y&pnids=&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

Locality

getLocalityInfo

Description

Get basic information for a specific locality, including specimen occurrences, place hierarchy, and coordinates.

Parameters
  • loc_id: number
  • tnuid: number
  • inst_id: number
  • per_id: number
  • pnid: number
  • showChildren: string
  • completeSpmInfo: string
  • format: string
  • key: string
Return
  • locInfo: array of loc_info with below extensions
    • hier: array of place
    • cuids: array of record_vouchered (only present if specified) or array of cuid
    • sex: array of spm_sex
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getLocalityInfo?loc_id=1&tnuid=30148&inst_id=1&per_id=1&pnid=1&showChildren=Y&completeSpmInfo=Y&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getUnvLocalityInfo

Description

Get locality information and occurrences (specimens) for a selected locality. The request can be narrowed down further by selected multiple parameter options.

Parameters
  • loc_id: number
  • tnuid: number
  • per_id: number
  • pnid: number
  • showChildren: string
  • format: string
  • key: string
Return
  • locInfo: loc_info with below extensions
    • hier: array of place
    • cuids: array of cuid
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getUnvLocalityInfo?loc_id=1&tnuid=30148&per_id=1&pnid=1&showChildren=Y&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

Place / Geopolitical Entity

getPlaceInfo

Description

Get basic place information including the place hierarchy, number of specimens, and number of species.

Parameters
  • place_id: number
  • format: string
  • key: string
Return
  • place_info: place with below extension
    • hier: array of place
    • num_species: number
    • num_spms: number
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getPlaceInfo?place_id=1&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getSubdivisions

Description

Get smaller levels of divisions for a selected place.

Parameters
  • place_id: number
  • format: string
  • key: string
Return
  • subdivs: array of place
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getSubdivisions?place_id=1&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getGeoTaxa

Description

Get taxonomic information from a specified place.

Parameters
  • place_id: number
  • format: string
  • key: string
Return
  • taxa: array of taxon_basic with below extensions
    • valid_taxon: taxon_basic (only present when defined)
    • hier: taxon_hierarchy
    • count: number
    • rank: string
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getGeoTaxa?place_id=1&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getGeoCollTrips

Description

Get collecting trips info for a specified place.

Parameters
  • place_id: number
  • format: string
  • key: string
Return
  • coll_trips: array of loc_basic and collector.
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getGeoCollTrips?place_id=1&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getGeoCollTrips2

Description

Get collecting trips and taxa info for a specified place.

Parameters
  • place_id: number
  • format: string
  • key: string
Return
  • coll_trips: array of taxon_basic, collection, collector and loc_basic with below extension
    • valid_taxon: taxon_basic (only present when defined)
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getGeoCollTrips2?place_id=1&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getGeoInsts

Description

Get institutions from a selected place.

Parameters
  • place_id: number
  • format: string
  • key: string
Return
  • collections: array of collection_extended
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getGeoInsts?place_id=1&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

Literature

getLitReference

Description

Get the reference for a selected publication.

Parameters
  • pub_id: number
  • format: string
  • key: string
Return
  • pub_ref: literature_extended
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getLitReference?pub_id=419&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getLitParts

Description

Get parts of the selected publication, such as pages, pdf urls, chapters, titles, authors, and more.

Parameters
  • pub_id: number
  • format: string
  • key: string
Return
  • pub_parts: array of literature_extended
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getLitParts?pub_id=20239&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getPubTaxonCitation

Description

Get cited taxon information from a selected publication.

Parameters
  • pub_id: number
  • format: string
  • key: string
Return
  • pub_cits: array of pub_basic and taxon_basic with below extensions
    • tnucid: number
    • rank: string
  • public: string
  • author: string
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getPubTaxonCitation?pub_id=419&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getPubAssocCitation

Description
Parameters
  • pub_id: number
  • format: string
  • key: string
Return
  • assoc_cits: array of ..
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getPubAssocCitation?pub_id=23683&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

Journal

getJournalInfo

Description
Parameters
  • jrnl_id: number
  • format: string
  • key: string
Return
  • journal_info: array of below elements
    • name: string
    • url: string
    • is_public: string
    • copyright_holder: string
    • num_articles: number
    • num_pdfs: number
    • num_taxa: number
    • last_article_time: string
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getJournalInfo?jrnl_id=1&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getJournalPubs

Description
Parameters
  • jrnl_id: number
  • format: string
  • key: string
Return
  • pubs: array of literature_extended
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getJournalPubs?jrnl_id=1&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getJournalTaxa

Description
Parameters
  • jrnl_id: number
  • format: string
  • key: string
Return
  • taxa: array of taxon_basic
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getJournalTaxa?jrnl_id=1&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

Institution

getCollectionInfo

Description
Parameters
  • inst_id: number
  • format: string
  • key: string
Return
  • collection_info: array of collection_extended with below extensions
    • vouchered: boolean
    • num_prim_types: number
    • num_sec_types: number
    • num_species: number
    • last_spm_time: string
    • oldest_spm: array of below elements
      • cuid: string
      • coll_date: string
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getCollectionInfo?inst_id=21&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getPrimaryTypes

Description

Get specimen of which the description of a new species is based.

Parameters
  • inst_id: number
  • format: string
  • key: string
Return
  • types: array of type
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getPrimaryTypes?inst_id=6&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getSecondaryTypes

Description

Get specimen that are occurrences of a specific species, but not a primary type.

Parameters
  • inst_id: number
  • format: string
  • key: string
Return
  • types: array of type
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getSecondaryTypes?inst_id=6&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getInstTaxa

Description

Get taxa and related taxonomic information from a selected institution.

Parameters
  • inst_id: number
  • format: string
  • key: string
Return
  • taxa: array of taxon_extended with below extension
    • hier: taxon_hierarchy
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getInstTaxa?inst_id=21&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getInstCollTrips2

Description

Get collecting trip events and the specimen collected for a selected institution.

Parameters
  • inst_id: number
  • format: string
  • key: string
Return
  • coll_trips: array of taxon_basic, collection, collector, and loc_basic.
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getInstCollTrips2?inst_id=21&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getInstPubs

Description

Get published literature from a selected institution.

Parameters
  • inst_id: number
  • format: string
  • key: string
Return
  • pubs: array of literature_extended
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getInstPubs?inst_id=1&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

Text Search

getSearchResults

Description

Get database results from a text keyword search.

Parameters
  • name: string
  • limit: number
  • categoryLimit: string
  • format: string
  • key: string
Return
  • taxon_results: array of below extensions
    • taxa: array of taxon_extended with below extension
      • lsid: number
    • count: number
  • cuid_results: array of below extensions
    • cuids: array of cuids
    • count: number
  • agent_results: array of below extensions
    • agents: array of below extensions
      • type: string
      • id: number
      • name: string
      • inst: string
    • count: number
  • inst_results: array of below extensions
    • inst: array of collection_extended
    • count: number
  • place_results: array of below extensions
    • places: array of place with below extension
      • hier: array of place
    • count: number
  • journal_results: array of below extensions
    • journals: array of below extensions
      • name: string
      • id: number
    • count: number
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getSearchResults?name=%OSU%&limit=20&categoryLimit=&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getTaxaFromText

Description

Get taxa results from a selected search keyword.

Parameters
  • name: string
  • limit: number
  • nameOnly: string
  • format: string
  • key: string
Return
  • taxa: array of taxon_extended with below extensions
    • lsid: number
  • count: number
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getTaxaFromText?name=Heptascelio+striatosternus&limit=10&nameOnly=N&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getCuidsFromText

Description

Get occurrence results from a selected search keyword.

Parameters
  • name: string
  • limit: number
  • format: string
  • key: string
Return
  • cuids: array of cuid
  • count: number
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getCuidsFromText?name=%OSUC%&limit=10&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getAgentsFromText

Description

Get agent (person and/or party) results from a selected search keyword.

Parameters
  • name: string
  • limit: number
  • includeParty: string
  • format: string
  • key: string
Return
  • agents: array of below elements
    • id: number
    • type: string
    • name: string
    • inst: string
  • count: number
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getAgentsFromText?name=%Johnson,%20N.%20F.%&limit=10&includeParty=Y&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getInstFromText

Description

Get institution/collection results from a selected search keyword(s).

Parameters
  • name: string
  • limit: number
  • format: string
  • key: string
Return
  • inst: array of collection_extended
  • count: number
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getInstFromText?name=Hymenoptera&limit=10&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getJournalsFromText

Description

Get journal results from a selected search keyword(s).

Parameters
  • name: string
  • limit: number
  • format: string
  • key: string
Return
  • journals: array of below elements
    • name: string
    • id: number
  • count: number
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getJournalsFromText?name=Insect&limit=10&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getOrgsFromText

Description

Get organization results for a selected search keyword(s).

Parameters
  • name: string
  • limit: number
  • format: string
  • key: string
Return
  • orgs: array of below elements
    • name: string
    • id: number
  • count: number
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getOrgsFromText?name=%Geo%&limit=10&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getPlacesFromText

Description
Parameters
  • name: string
  • limit: number
  • format: string
  • key: string
Return
  • places: array of place with below extension
    • hier: array of place
  • count: number
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getPlacesFromText?name=Guyana&limit=10&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getLocalitiesFromText

Description
Parameters
  • name: string
  • limit: number
  • format: string
  • key: string
Return
  • locs: array of below elements
    • name: string
    • id: number
  • count: number
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getLocalitiesFromText?name=Guyana&limit=10&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

getCollMethodsFromText

Description
Parameters
  • name: string
  • limit: number
  • format: string
  • key: string
Return
  • coll_methods: array of below elements
    • name: string
    • id: number
  • count: number
Example

https://osuc.biosci.ohio-state.edu/cgi-bin/OJ_Break_API.py/getCollMethodsFromText?name=reared&limit=10&format=json&key=FBF57A9F7A666FC0E0430100007F0CDC

Data Type Glossary

OJ_Break API Data Type Glossary

Retrieved from "https://xbiod.osu.edu/index.php?title=OJ_Break_API_Reference&oldid=2263"