Actions16
Overview
This node interacts with the Audiobookshelf API to retrieve the cover image of a specific library item. It is useful when you want to fetch and display or process the cover art associated with an audiobook or other media stored in your Audiobookshelf library.
Practical examples include:
- Displaying the cover image in a custom dashboard or app.
- Downloading and saving the cover image for archival or further processing.
- Using the cover image as part of a media metadata enrichment workflow.
Properties
| Name | Meaning |
|---|---|
| Library Item ID | The unique identifier of the library item whose cover image you want to retrieve. This is a required string input. |
Output
The node outputs JSON data containing information about the requested library item's cover. The exact structure depends on the API response but typically includes metadata about the cover image such as URL, format, or binary data if the image is downloaded directly.
If the node supports binary output (not explicitly shown in the provided code), it would represent the cover image file itself, allowing downstream nodes to handle or save the image.
Dependencies
- Requires an API key credential for authenticating with the Audiobookshelf API.
- Needs the base URL of the Audiobookshelf instance configured via credentials.
- Relies on the Audiobookshelf API being accessible and responsive.
Troubleshooting
- Invalid Library Item ID: If the provided ID does not exist or is malformed, the API will likely return an error. Verify the ID is correct.
- Authentication Errors: Ensure the API key credential is valid and has sufficient permissions.
- Network Issues: Connectivity problems between n8n and the Audiobookshelf server can cause failures.
- API Changes: If the Audiobookshelf API changes, the node might fail to retrieve covers until updated.
Common error messages may include unauthorized access, not found errors, or timeout errors. Resolving these involves checking credentials, verifying IDs, and ensuring network connectivity.
Links and References
- Audiobookshelf Official Website
- Audiobookshelf API Documentation (if publicly available)