Difference between revisions of "OJ Break API Reference"

From xBio:D Wiki
Jump to navigation Jump to search
Line 289: Line 289:
 
===== Example =====
 
===== Example =====
 
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getTaxonStatsForYear?tnuid=30148&stats_year=2014&callback=api
 
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getTaxonStatsForYear?tnuid=30148&stats_year=2014&callback=api
−
 
  
 
=== Occurrence / Specimen ===
 
=== Occurrence / Specimen ===
−
 
 
==== getSpmInfo ====
 
==== getSpmInfo ====
 
===== Description =====
 
===== Description =====
Line 314: Line 312:
 
===== Example =====
 
===== Example =====
 
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getSpmsInfo?cuid=OSUC+59557&callback=api
 
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getSpmsInfo?cuid=OSUC+59557&callback=api
−
 
  
 
=== Locality ===
 
=== Locality ===
−
 
 
==== getLocalityInfo ====
 
==== getLocalityInfo ====
 
===== Description =====
 
===== Description =====
Line 334: Line 330:
 
===== Example =====
 
===== Example =====
 
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getLocalityInfo?locID=&tnuid=30148&inst_id=1&per_id&pnid=&showChildren=Y&completeSpmInfo=Y&callback=api
 
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getLocalityInfo?locID=&tnuid=30148&inst_id=1&per_id&pnid=&showChildren=Y&completeSpmInfo=Y&callback=api
−
 
−
 
−
{|
 
−
! 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)
 
−
|
 
−
|
 
−
|}
 
−
 
  
 
=== Place / Geopolitical Entity ===
 
=== Place / Geopolitical Entity ===
−
 
−
 
 
==== getPlaceInfo ====
 
==== getPlaceInfo ====
 
===== Description =====
 
===== Description =====
Line 360: Line 342:
 
===== Example =====
 
===== Example =====
 
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getPlaceInfo?place_id=&callback=api
 
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getPlaceInfo?place_id=&callback=api
−
 
  
 
==== getSubdivisions ====
 
==== getSubdivisions ====
Line 418: Line 399:
  
 
=== Literature ===
 
=== Literature ===
−
 
 
==== getLitReference ====
 
==== getLitReference ====
 
===== Description =====
 
===== Description =====
Line 463: Line 443:
 
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getPubAssocCitation?pub_id=&callback=api
 
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getPubAssocCitation?pub_id=&callback=api
  
 +
=== Journal ===
 +
==== getJournalInfo ====
 +
===== Description =====
 +
 +
===== Parameters =====
 +
* ''jrnl_id'': number
 +
* ''callback'': string
 +
===== Return =====
 +
*
 +
===== Example =====
 +
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getJournalInfo?jrnl_id=&callback=api
  
−
=== Journal ===
+
==== getJournalPubs ====
−
{|
+
===== Description =====
−
! align="left"| Method
+
 
−
! align="left"| Return
+
===== Parameters =====
−
! align="left"| Description
+
* ''jrnl_id'': number
−
|-
+
* ''callback'': string
−
|getJournalInfo(jrnl_id:number, callback:string)
+
===== Return =====
−
|
+
*
−
|
+
===== Example =====
−
|-
+
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getJournalPubs?jrnl_id=&callback=api
−
|getJournalPubs(jrnl_id:number, callback:string)
 
−
|
 
−
|
 
−
|-
 
−
|getJournalTaxa(jrnl_id:number, callback:string)
 
−
|
 
−
|
 
−
|}
 
  
 +
==== getJournalTaxa ====
 +
===== Description =====
 +
 +
===== Parameters =====
 +
* ''jrnl_id'': number
 +
* ''callback'': string
 +
===== Return =====
 +
*
 +
===== Example =====
 +
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getJournalTaxa?jrnl_id=&callback=api
  
 
=== Institution ===
 
=== Institution ===
−
{|
+
==== getCollectionInfo ====
−
! align="left"| Method
+
===== Description =====
−
! align="left"| Return
+
 
−
! align="left"| Description
+
===== Parameters =====
−
|-
+
* ''inst_id'': number
−
|getCollectionInfo(inst_id:number, callback:string)
+
* ''callback'': string
−
|
+
===== Return =====
−
|
+
*
−
|-
+
===== Example =====
−
|getPrimaryTypes(inst_id:number, callback:string)
+
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getCollectionInfo?inst_id=21&callback=api
−
|
+
 
−
|
+
==== getPrimaryTypes ====
−
|-
+
===== Description =====
−
|getSecondaryTypes(inst_id:number, callback:string)
+
 
−
|
+
===== Parameters =====
−
|
+
* ''inst_id'': number
−
|-
+
* ''callback'': string
−
|getInstTaxa(inst_id:number, callback:string)
+
===== Return =====
−
|
+
*
−
|
+
===== Example =====
−
|-
+
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getPrimaryTypes?inst_id=6&callback=api
−
|getInstCollTrips2(inst_id:number, callback:string)
+
 
−
|
+
==== getSecondaryTypes ====
−
|
+
===== Description =====
−
|-
+
 
−
|getInstPubs(inst_id:number, callback:string)
+
===== Parameters =====
−
|
+
* ''inst_id'': number
−
|
+
* ''callback'': string
−
|}
+
===== Return =====
 +
*
 +
===== Example =====
 +
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getSecondaryTypes?inst_id=6&callback=api
 +
 
 +
==== getInstTaxa ====
 +
===== Description =====
 +
 
 +
===== Parameters =====
 +
* ''inst_id'': number
 +
* ''callback'': string
 +
===== Return =====
 +
*
 +
===== Example =====
 +
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getInstTaxa?inst_id=21&callback=api
  
 +
==== getInstCollTrips2 ====
 +
===== Description =====
 +
 +
===== Parameters =====
 +
* ''inst_id'': number
 +
* ''callback'': string
 +
===== Return =====
 +
*
 +
===== Example =====
 +
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getInstCollTrips2?inst_id=21&callback=api
 +
 +
==== getInstPubs ====
 +
===== Description =====
 +
 +
===== Parameters =====
 +
* ''inst_id'': number
 +
* ''callback'': string
 +
===== Return =====
 +
*
 +
===== Example =====
 +
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getInstPubs?inst_id=1&callback=api
  
 
=== Unvouchered Record ===
 
=== Unvouchered Record ===
−
{|
+
==== getUnvoucheredRecord ====
−
! align="left"| Method
+
===== Description =====
−
! align="left"| Return
 
−
! align="left"| Description
 
−
|-
 
−
|getUnvoucheredRecord(unv_id:number, callback:string)
 
−
|
 
−
|
 
−
|-
 
−
|getUnvoucheredRecords(tnuid:number, showChildren:<nowiki>Y|N</nowiki>, pnids:array of number, callback:string)
 
−
|
 
−
|
 
−
|-
 
−
|getUnvoucheredRecords(tnuids:array of number, pnids:array of number, callback:string)
 
−
|
 
−
|
 
−
|-
 
−
|getUnvLocalityInfo(locID:number, tnuid:number, per_id:number, pnid:number, showChildren:<nowiki>Y|N</nowiki>, callback:string)
 
−
|
 
−
|
 
−
|}
 
  
 +
===== Parameters =====
 +
* ''univ_id'': number
 +
* ''callback'': string
 +
===== Return =====
 +
*
 +
===== Example =====
 +
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getUnvoucheredRecord?univ_id=1&callback=api
 +
 +
==== getUnvoucheredRecords ====
 +
===== Description =====
 +
 +
===== Parameters =====
 +
* ''tnuid'': number
 +
* ''showChildren'': string
 +
* ''pnids'': array of number
 +
* ''callback'': string
 +
===== Return =====
 +
*
 +
===== Example =====
 +
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getUnvoucheredRecords?univ_id=1&showChildren=Y&pnids=&callback=api
 +
 +
==== getUnvoucheredRecords ====
 +
===== Description =====
 +
 +
===== Parameters =====
 +
* ''tnuid'': number
 +
* ''pnids'': array of number
 +
* ''callback'': string
 +
===== Return =====
 +
*
 +
===== Example =====
 +
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getUnvoucheredRecords?univ_id=1&pnids=&callback=api
 +
 +
==== getUnvLocalityInfo ====
 +
===== Description =====
 +
 +
===== Parameters =====
 +
* ''locID'': number
 +
* ''tnuid'': number
 +
* ''per_id'': number
 +
* ''pnid'': number
 +
* ''showChildren'': string
 +
* ''callback'': string
 +
===== Return =====
 +
*
 +
===== Example =====
 +
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getUnvLocalityInfo?locID=&tnuid=30148&per_id=&pnid=&showChildren=Y&callback=api
  
 
=== Text Search ===
 
=== Text Search ===
−
{|
+
==== getSearchResults ====
−
! align="left"| Method
+
===== Description =====
−
! align="left"| Return
+
 
−
! align="left"| Description
+
===== Parameters =====
−
|-
+
* ''name'': string
−
|getSearchResults(name:string, limit:number, categoryLimit:string, callback:string)
+
* ''limit'': number
−
|
+
* ''categoryLimit'': string
−
|
+
* ''callback'': string
−
|-
+
===== Return =====
−
|getTaxaFromText(name:string, limit:number, nameOnly:<nowiki>Y|N</nowiki>, callback:string)
+
*
−
|
+
===== Example =====
−
|
+
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getSearchResults?name=&limit=&categoryLimit=&callback=api
−
|-
+
 
−
|getCuidsFromText(name:string, limit:number, callback:string)
+
==== getTaxaFromText ====
−
|
+
===== Description =====
−
|
+
 
−
|-
+
===== Parameters =====
−
|getAgentsFromText(name:string, limit:number, includeParty:<nowiki>Y|N</nowiki>, callback:string)
+
* ''name'': string
−
|
+
* ''limit'': number
−
|
+
* ''nameOnly'': string
−
|-
+
* ''callback'': string
−
|getInstFromText(name:string, limit:number, callback:string)
+
===== Return =====
−
|
+
*
−
|
+
===== Example =====
−
|-
+
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getTaxaFromText?name=&limit=&nameOnly=Y&callback=api
−
|getJournalsFromText(name:string, limit:number, callback:string)
+
 
−
|
+
==== getCuidsFromText ====
−
|
+
===== Description =====
−
|-
+
 
−
|getOrgsFromText(name:string, limit:number, callback:string)
+
===== Parameters =====
−
|
+
* ''name'': string
−
|
+
* ''limit'': number
−
|-
+
* ''callback'': string
−
|getPlacesFromText(name:string, limit:number, callback:string)
+
===== Return =====
−
|
+
*
−
|
+
===== Example =====
−
|-
+
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getCuidsFromText?name=&limit=&callback=api
−
|getLocalitiesFromText(name:string, limit:number, callback:string)
+
 
−
|
+
==== getAgentsFromText ====
−
|
+
===== Description =====
−
|-
+
 
−
|getCollMethodsFromText(name:string, limit:number, callback:string)
+
===== Parameters =====
−
|
+
* ''name'': string
−
|
+
* ''limit'': number
−
|}
+
* ''includeParty'': string
 +
* ''callback'': string
 +
===== Return =====
 +
*
 +
===== Example =====
 +
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getAgentsFromText?name=&limit=&includeParty=Y&callback=api
 +
 
 +
==== getInstFromText ====
 +
===== Description =====
 +
 
 +
===== Parameters =====
 +
* ''name'': string
 +
* ''limit'': number
 +
* ''callback'': string
 +
===== Return =====
 +
*
 +
===== Example =====
 +
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getInstFromText?name=&limit=&callback=api
 +
 
 +
==== getJournalsFromText ====
 +
===== Description =====
 +
 
 +
===== Parameters =====
 +
* ''name'': string
 +
* ''limit'': number
 +
* ''callback'': string
 +
===== Return =====
 +
*
 +
===== Example =====
 +
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getJournalsFromText?name=&limit=&callback=api
 +
 
 +
==== getOrgsFromText ====
 +
===== Description =====
 +
 
 +
===== Parameters =====
 +
* ''name'': string
 +
* ''limit'': number
 +
* ''callback'': string
 +
===== Return =====
 +
*
 +
===== Example =====
 +
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getOrgsFromText?name=&limit=&callback=api
 +
 
 +
==== getPlacesFromText ====
 +
===== Description =====
 +
 
 +
===== Parameters =====
 +
* ''name'': string
 +
* ''limit'': number
 +
* ''callback'': string
 +
===== Return =====
 +
*
 +
===== Example =====
 +
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getPlacesFromText?name=&limit=&callback=api
 +
 
 +
==== getLocalitiesFromText ====
 +
===== Description =====
 +
 
 +
===== Parameters =====
 +
* ''name'': string
 +
* ''limit'': number
 +
* ''callback'': string
 +
===== Return =====
 +
*
 +
===== Example =====
 +
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getLocalitiesFromText?name=&limit=&callback=api
 +
 
 +
==== getCollMethodsFromText ====
 +
===== Description =====
 +
 
 +
===== Parameters =====
 +
* ''name'': string
 +
* ''limit'': number
 +
* ''callback'': string
 +
===== Return =====
 +
*
 +
===== Example =====
 +
http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getCollMethodsFromText?name=&limit=&callback=api
  
 
== Data Type Glossary ==
 
== Data Type Glossary ==

Revision as of 18:57, 23 May 2014

Introduction

OJ_Break is the name of the xBio:D RESTful(-like) API service to facilitate discovery of data within the xBio:D database. 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.


Contents

Overview

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: http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.[method]?[argument1]=[value1]&...

  • Example: http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getTaxonInfo?tnuid=5012&callback=test
  • Response: test({"taxon":"Oxyscelio consobrinus","author":"(Kieffer)","status":"Subsequent name/combination","rank":"Species","valid":"Valid","fossil":"N","rel_type":"Member",...


Procedural Reference

Taxon

getTaxonStats

Description

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

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

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getTaxonStats?tnuid=30148&callback=api

getTaxonInfo

Description

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

Parameters
  • tnuid: number
  • inst_id: number
  • callback: 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

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getTaxonInfo?tnuid=30148&inst_id=0&callback=api

getTaxonHierarchy

Description

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

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

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getTaxonHierarchy?tnuid=30148&callback=api

getIncludedTaxa

Description

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

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

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getIncludedTaxa?tnuid=491&inst_id=0&showSyns=Y&showFossils=Y&types_only=N&show_num_spms=Y&callback=api

getTaxonSynonyms

Description

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

Parameters
  • tnuid: number
  • showFossils: string
  • callback: string
Return
  • synonyms: array of taxon_rel_extended
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getTaxonSynonyms?tnuid=30148&showFossils=Y&callback=api

getLocalities

Description

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

Parameters
  • tnuid: number
  • inst_id: number
  • precDecimals: number
  • showChildren: string
  • callback: string
Return
  • localities: array of loc_coords
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getLocalities?tnuid=30148&inst_id=0&precDecimals=4&showChildren=Y&callback=api

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: string
  • callback: string
Return
  • localities: array of loc_coords
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getLocalities?tnuid=30148&pnids=5816,5735&inst_id=0&precDecimals=4&showChildren=Y&callback=api

getCuids

Description

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

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

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getCuids?tnuid=30148&showChildren=Y&inst_id=1&pnids=&callback=api

getCuids

Description

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

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

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getCuids?tnuids=30148,491&pnids=5816,5735&callback=api

getTypes

Description
Parameters
  • tnuid: number
  • showSyns: string
  • inst_id: number
  • primary_only: string
  • taxon_author_search: string
  • offset: number
  • limit: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getTypes?tnuid=52&showSyns=F&inst_id=1&primary_only=Y&taxon_author_search=&offset=1&limit=10&callback=api

getInsts

Description
Parameters
  • tnuid: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getInsts?tnuid=30148&callback=api

getTaxonLiterature

Description

Deprecated

Parameters
  • tnuid: number
  • showSyns: string
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getTaxonLiterature?tnuid=30148&showSyns=Y&callback=api

getTaxonLit

Description

Preferred

Parameters
  • tnuid: number
  • showSyns: string
  • callback: string
Return
  • pubs: array of pubs
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getTaxonLit?tnuid=30148&showSyns=Y&callback=api

getAssociations

Description
Parameters
  • tnuid: number
  • rank_grouping: string
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getAssociations?tnuid=30148&rank_grouping=&callback=api

getHabitats

Description
Parameters
  • tnuid: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getHabitats?tnuid=30148&callback=api

getTaxonImages

Description
Parameters
  • tnuid: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getTaxonImages?tnuid=30148&callback=api

getTaxonBreakdown

Description
Parameters
  • tnuid: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getTaxonBreakdown?tnuid=30148&callback=api

getTaxonPhenology

Description
Parameters
  • tnuid: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getTaxonPhenology?tnuid=30148&callback=api

getTaxonNewTaxaByPub

Description
Parameters
  • tnuid: number
  • validOnly: string
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getTaxonNewTaxaByPub?tnuid=52&validOnly=Y&callback=api

getTaxonNewTaxaByYear

Description
Parameters
  • tnuid: number
  • validOnly: string
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getTaxonNewTaxaByYear?tnuid=52&validOnly=Y&callback=api

getTaxonStatsForYear

Description
Parameters
  • tnuid: number
  • stats_year: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getTaxonStatsForYear?tnuid=30148&stats_year=2014&callback=api

Occurrence / Specimen

getSpmInfo

Description
Parameters
  • cuid: string
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getSpmInfo?cuid=OSUC+59557&callback=api

getSpmsInfo

Description
Parameters
  • cuids: array of string
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getSpmsInfo?cuid=OSUC+59557&callback=api

Locality

getLocalityInfo

Description
Parameters
  • locID: number
  • tnuid: number
  • inst_id: number
  • per_id: number
  • pnid: number
  • showChildren: string
  • completeSpmInfo: string
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getLocalityInfo?locID=&tnuid=30148&inst_id=1&per_id&pnid=&showChildren=Y&completeSpmInfo=Y&callback=api

Place / Geopolitical Entity

getPlaceInfo

Description
Parameters
  • place_id: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getPlaceInfo?place_id=&callback=api

getSubdivisions

Description
Parameters
  • place_id: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getSubdivisions?place_id=&callback=api

getGeoTaxa

Description
Parameters
  • place_id: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getGeoTaxa?place_id=&callback=api

getGeoCollTrips

Description
Parameters
  • place_id: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getGeoCollTrips?place_id=&callback=api

getGeoCollTrips2

Description
Parameters
  • place_id: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getGeoCollTrips2?place_id=&callback=api

getGeoInsts

Description
Parameters
  • place_id: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getGeoTaxa?place_id=&callback=api

Literature

getLitReference

Description
Parameters
  • pub_id: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getLitReference?pub_id=&callback=api

getLitParts

Description
Parameters
  • pub_id: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getLitParts?pub_id=&callback=api

getPubTaxonCitation

Description
Parameters
  • pub_id: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getPubTaxonCitation?pub_id=&callback=api

getPubAssocCitation

Description
Parameters
  • pub_id: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getPubAssocCitation?pub_id=&callback=api

Journal

getJournalInfo

Description
Parameters
  • jrnl_id: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getJournalInfo?jrnl_id=&callback=api

getJournalPubs

Description
Parameters
  • jrnl_id: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getJournalPubs?jrnl_id=&callback=api

getJournalTaxa

Description
Parameters
  • jrnl_id: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getJournalTaxa?jrnl_id=&callback=api

Institution

getCollectionInfo

Description
Parameters
  • inst_id: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getCollectionInfo?inst_id=21&callback=api

getPrimaryTypes

Description
Parameters
  • inst_id: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getPrimaryTypes?inst_id=6&callback=api

getSecondaryTypes

Description
Parameters
  • inst_id: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getSecondaryTypes?inst_id=6&callback=api

getInstTaxa

Description
Parameters
  • inst_id: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getInstTaxa?inst_id=21&callback=api

getInstCollTrips2

Description
Parameters
  • inst_id: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getInstCollTrips2?inst_id=21&callback=api

getInstPubs

Description
Parameters
  • inst_id: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getInstPubs?inst_id=1&callback=api

Unvouchered Record

getUnvoucheredRecord

Description
Parameters
  • univ_id: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getUnvoucheredRecord?univ_id=1&callback=api

getUnvoucheredRecords

Description
Parameters
  • tnuid: number
  • showChildren: string
  • pnids: array of number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getUnvoucheredRecords?univ_id=1&showChildren=Y&pnids=&callback=api

getUnvoucheredRecords

Description
Parameters
  • tnuid: number
  • pnids: array of number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getUnvoucheredRecords?univ_id=1&pnids=&callback=api

getUnvLocalityInfo

Description
Parameters
  • locID: number
  • tnuid: number
  • per_id: number
  • pnid: number
  • showChildren: string
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getUnvLocalityInfo?locID=&tnuid=30148&per_id=&pnid=&showChildren=Y&callback=api

Text Search

getSearchResults

Description
Parameters
  • name: string
  • limit: number
  • categoryLimit: string
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getSearchResults?name=&limit=&categoryLimit=&callback=api

getTaxaFromText

Description
Parameters
  • name: string
  • limit: number
  • nameOnly: string
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getTaxaFromText?name=&limit=&nameOnly=Y&callback=api

getCuidsFromText

Description
Parameters
  • name: string
  • limit: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getCuidsFromText?name=&limit=&callback=api

getAgentsFromText

Description
Parameters
  • name: string
  • limit: number
  • includeParty: string
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getAgentsFromText?name=&limit=&includeParty=Y&callback=api

getInstFromText

Description
Parameters
  • name: string
  • limit: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getInstFromText?name=&limit=&callback=api

getJournalsFromText

Description
Parameters
  • name: string
  • limit: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getJournalsFromText?name=&limit=&callback=api

getOrgsFromText

Description
Parameters
  • name: string
  • limit: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getOrgsFromText?name=&limit=&callback=api

getPlacesFromText

Description
Parameters
  • name: string
  • limit: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getPlacesFromText?name=&limit=&callback=api

getLocalitiesFromText

Description
Parameters
  • name: string
  • limit: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getLocalitiesFromText?name=&limit=&callback=api

getCollMethodsFromText

Description
Parameters
  • name: string
  • limit: number
  • callback: string
Return
Example

http://osuc.biosci.ohio-state.edu/hymDB/OJ_Break.getCollMethodsFromText?name=&limit=&callback=api

Data Type Glossary

OJ_Break API Data Type Glossary

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