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
Projects → Get
AI-generatedOverview
This node integrates with the TaxonWorks API, a web-based workbench for taxonomists and biodiversity scientists. It allows users to retrieve data from various TaxonWorks resources by performing "Get" operations. Specifically, for the Projects resource with the Get operation, it fetches project-related information from the specified TaxonWorks server.
Typical use cases include:
- Retrieving metadata about projects managed in a TaxonWorks instance.
- Automating workflows that require project details for further processing or reporting.
- Integrating TaxonWorks project data into other systems or dashboards.
Example: A user wants to get a list of all projects available on their TaxonWorks server to display them in a custom dashboard or to trigger downstream automation based on project attributes.
Properties
| Name | Meaning |
|---|---|
| Server | The URL of the TaxonWorks server to connect to (e.g., https://sfg.taxonworks.org). This is where the API requests will be sent. |
Output
The node outputs JSON data representing the response from the TaxonWorks API for the requested Projects resource. The structure corresponds to the project data returned by the /api/v1 endpoint of the TaxonWorks server, including project details such as IDs, names, descriptions, and other metadata.
No binary data output is produced by this node.
Dependencies
- Requires an active connection to a TaxonWorks server.
- Requires two credentials:
- An API token credential for user authentication.
- A project token credential for project-specific access.
- The node uses HTTP GET requests to the TaxonWorks REST API endpoints.
- The user must configure the node with the correct server URL and valid credentials.
Troubleshooting
- Invalid Credentials Error: If the API tokens are incorrect or expired, the node will fail to authenticate. Ensure that valid API tokens are provided.
- Connection Errors: If the server URL is incorrect or unreachable, the node will throw network errors. Verify the server address and network connectivity.
- Empty or Unexpected Response: If the project data is not found or the API changes, the node may return empty arrays or error messages. Confirm the resource and operation parameters and check the TaxonWorks API documentation for updates.
- Rate Limiting or API Limits: Frequent requests might hit API rate limits; handle such errors by adding delays or retries.
Links and References
- TaxonWorks Official Website
- TaxonWorks API Documentation (Assumed location; verify with actual docs)
- n8n Documentation on HTTP Request Node (for understanding underlying request mechanics)
Note: This summary focuses on the Projects resource with the Get operation as requested. The node supports many other resources and operations, but they are outside the scope of this extraction.