CatalogueOfLife icon

CatalogueOfLife

The most complete authoritative list of the world's species, maintained by hundreds of global taxonomists
Join our community

Actions12

  • Decision Actions
  • Estimate Actions
  • Name Actions
  • Name Usage Actions
  • Name Usage Search Actions
  • Name Usage Suggest Actions
  • Reference Actions
  • Source Metadata Actions
  • Synonym Actions
  • Taxon Actions
  • Tree Actions
  • Vernacular Actions

Overview

This node integrates with the Catalogue of Life API, which provides a comprehensive and authoritative list of the world's species maintained by global taxonomists. Specifically, the "Source Metadata" resource with the "Get" operation allows users to retrieve metadata about source datasets from the Catalogue of Life.

Common scenarios for this node include:

  • Fetching detailed information about specific source datasets used in biodiversity projects.
  • Filtering source datasets based on whether they are current or not.
  • Integrating authoritative species data into workflows for research, conservation, or educational purposes.

For example, a user might want to get metadata about a particular source dataset by its ID or retrieve only those sources that are not currently active.

Properties

Name Meaning
Additional Fields Collection of optional fields:
- Not Current Only Boolean flag to filter results to only include source datasets that are not current.
- ID String specifying the source dataset ID to retrieve metadata for a specific dataset.

Output

The node outputs an array of JSON objects representing the source metadata retrieved from the Catalogue of Life API. Each object contains detailed information about a source dataset, such as its identifiers, status, and other metadata fields provided by the API.

No binary data output is produced by this node.

Dependencies

  • Requires internet access to call the Catalogue of Life public API at https://api.checklistbank.org/dataset/3LR/source.
  • No explicit API key or authentication is required according to the code.
  • The node uses standard HTTP GET requests with JSON responses.

Troubleshooting

  • Empty or no results: Ensure that the provided source dataset ID is correct or try toggling the "Not Current Only" option appropriately.
  • Network errors: Verify internet connectivity and that the Catalogue of Life API endpoint is reachable.
  • Invalid parameter values: Check that the ID field is a valid string and "Not Current Only" is a boolean.
  • API changes: If the Catalogue of Life API changes its endpoints or parameters, the node may fail; verify the API documentation if issues arise.

Links and References

Discussion