Actions6
Taxon Name Usage → Get
AI-generatedOverview
This node integrates with ZooBank, a comprehensive zoological scientific names database. Specifically, the "Taxon Name Usage" resource with the "Get" operation allows users to retrieve detailed information about taxon name usages from ZooBank. This is useful for researchers, taxonomists, or biodiversity informatics professionals who need authoritative data on zoological nomenclature.
Typical use cases include:
- Fetching details of a specific taxon name usage by its unique identifier.
- Searching for taxon name usages by scientific name or general search terms.
- Integrating taxonomic data into biodiversity databases or workflows.
For example, a user might input a scientific name like "Aedes aegypti" to retrieve all related nomenclatural acts and usage details from ZooBank.
Properties
| Name | Meaning |
|---|---|
| Additional Fields | Collection of optional fields to refine the query: |
| - ID | A taxon name usage UUID (e.g., 6EA8BB2A-A57B-47C1-953E-042D8CD8E0E2) to fetch a specific record. |
| - Scientific Name | A scientific name (e.g., Aedes aegypti). Spaces are replaced with underscores internally. |
| - Search Term | A general search term to filter taxon name usages. |
Output
The node outputs an array of JSON objects representing the retrieved taxon name usage records from ZooBank. The structure corresponds directly to the ZooBank API response for nomenclatural acts, including details such as identifiers, scientific names, and other metadata related to taxon name usages.
No binary data output is produced by this node.
Dependencies
- Requires internet access to call the ZooBank public API endpoints.
- No explicit API key or authentication is required based on the source code.
- Uses standard HTTP GET requests with JSON responses.
Troubleshooting
- Empty or no results: Ensure that the provided ID, scientific name, or search term is correct and exists in ZooBank.
- Invalid UUID format: When using the ID field, verify that the UUID matches the expected pattern.
- Network errors: Check internet connectivity and ZooBank API availability.
- Unexpected response structure: If ZooBank changes their API, the node may fail to parse results correctly; monitor ZooBank API updates.
Links and References
- ZooBank Official Website
- ZooBank API Documentation (Note: The node uses endpoints like
/NomenclaturalActs.json)