TaxonWorks icon

TaxonWorks

TaxonWorks is an integrated web-based workbench for taxonomists and biodiversity scientists

Actions20

  • Asserted Distribution Actions
  • Biological Association Actions
  • Citation Actions
  • Collecting Event Actions
  • Collection Object Actions
  • Content Actions
  • Data Attribute Actions
  • Download Actions
  • Identifier Actions
  • Image Actions
  • Notes Actions
  • Observation Matrices Actions
  • Observations Actions
  • OTUs Actions
  • People Actions
  • Projects Actions
  • Sources Actions
  • Taxon Name Classifications Actions
  • Taxon Name Relationships Actions
  • Taxon Names Actions

Download → Get

AI-generated

Overview

This node integrates with the TaxonWorks API, a web-based workbench for taxonomists and biodiversity scientists. Specifically, the "Download" resource with the "Get" operation allows users to retrieve download records from a TaxonWorks server.

Typical use cases include:

  • Fetching metadata or details about downloadable files or datasets managed within a TaxonWorks project.
  • Automating retrieval of download information for further processing or reporting in workflows related to biodiversity data management.

For example, a user might want to get details of a specific download by its ID or list all downloads available in a project.

Properties

Name Meaning
Server The URL of the TaxonWorks server to connect to (e.g., https://sfg.taxonworks.org).
Additional Fields Optional parameters to specify additional query fields; currently supports:
- ID: The identifier of a specific download record to fetch.

Output

The node outputs JSON data representing the response from the TaxonWorks API for the requested download(s). The structure corresponds to the API's download resource representation, typically including metadata such as download ID, file details, timestamps, and associated project information.

No binary data output is produced by this node.

Dependencies

  • Requires an active connection to a TaxonWorks server.
  • Requires two credentials:
    • A user API token credential for authentication.
    • A project API token credential to specify the project context.
  • The node makes HTTP GET requests to the TaxonWorks REST API endpoints.

Troubleshooting

  • Authentication errors: Ensure that valid API tokens are provided via the required credentials. Invalid or expired tokens will cause authorization failures.
  • Server connectivity issues: Verify the server URL is correct and accessible from the n8n environment.
  • Invalid ID parameter: If specifying an ID in Additional Fields, ensure it matches an existing download record; otherwise, the API may return an error or empty result.
  • Unexpected API responses: Check if the TaxonWorks server version is compatible with the node's expected API endpoints.

Links and References

Discussion