Audiobookshelf icon

Audiobookshelf

Work with the Audiobookshelf API
Join our community

Actions16

Overview

This node interacts with the Audiobookshelf API to retrieve information about authors within a specified library. Specifically, the "Get Authors" operation under the "Library" resource fetches a list of authors associated with a given library ID. This is useful for scenarios where you want to display or process author data from an audiobook collection managed by Audiobookshelf.

Practical examples include:

  • Displaying all authors in a particular audiobook library on a dashboard.
  • Filtering or categorizing audiobooks by author.
  • Integrating author data into other workflows or applications.

Properties

Name Meaning
Library ID The unique identifier of the library from which to retrieve authors. This is a required string input.

Output

The output JSON will contain data representing the authors retrieved from the specified library. Typically, this includes author details such as names, IDs, and possibly metadata related to each author. The exact structure depends on the Audiobookshelf API response but generally consists of an array of author objects.

If the node supports binary data output (not indicated here), it would typically relate to author images or related media, but no such indication is present in the provided code snippet.

Dependencies

  • Requires an active connection to the Audiobookshelf API.
  • Needs an API authentication token credential configured in n8n to authorize requests.
  • The base URL for API requests is dynamically set based on the domain provided in the credentials.

Troubleshooting

  • Missing or invalid Library ID: Since the Library ID is required, ensure it is correctly provided; otherwise, the node will fail to retrieve authors.
  • Authentication errors: If the API key or token is missing or incorrect, the node will not be able to connect to the Audiobookshelf API.
  • Network issues: Connectivity problems to the specified domain can cause request failures.
  • API changes: Updates to the Audiobookshelf API might affect the response format or available endpoints, requiring updates to the node.

Links and References

Discussion