Lectful icon

Lectful

Interact with the VIPay Lectful API

Actions88

Overview

The "Get All Images" operation of the Lectful node retrieves a list of images from the Lectful API. It supports filtering to show only unused images and allows pagination by specifying how many images to return per page.

This operation is useful when you want to programmatically access all images stored in your Lectful account, for example, to synchronize image data with another system, audit unused images, or display image metadata in an automated workflow.

Practical examples:

  • Fetch all unused images to identify and clean up storage.
  • Retrieve a paginated list of images to display in a dashboard or report.
  • Integrate image metadata into other content management or marketing tools.

Properties

Name Meaning
Authentication Mode Choose how to authenticate with the Lectful API:
- Use Stored Credentials
- Manual Configuration (provide base URL and API key manually)
Base URL Override Optional base URL to override the credential setting (used only in Manual Configuration mode). Should not include /api/v1.
API Key Override Optional API key to override the credential setting (used only in Manual Configuration mode).
Show Unused Only Boolean flag to filter results to show only images that are unused (true or false). Default is false.
Per Page Number of images to retrieve per page (pagination size). Default is 15.

Output

The output is an array of JSON objects representing images retrieved from the Lectful API. Each object contains metadata about an image, such as its ID, usage status, and other relevant details provided by the API.

The node does not output binary image data directly; it only returns metadata information about the images.

Example output structure (simplified):

[
  {
    "id": "string",
    "url": "string",
    "filename": "string",
    "used": true,
    "created_at": "string",
    ...
  },
  ...
]

Dependencies

  • Requires access to the Lectful API.
  • Requires either stored credentials configured in n8n or manual entry of the Lectful API base URL and API key.
  • The API key must have permissions to read image data.
  • No additional external dependencies beyond standard HTTP requests.

Troubleshooting

  • Missing or invalid credentials: If using stored credentials, ensure they are correctly configured with a valid base URL and API key. If using manual mode, both Base URL Override and API Key Override must be provided.
  • API errors: Errors returned by the Lectful API (e.g., unauthorized, rate limits) will be surfaced. Check API key permissions and usage limits.
  • Empty results: If no images are returned, verify if the "Show Unused Only" filter is set and whether there are any unused images.
  • Pagination issues: Ensure the "Per Page" value is within acceptable limits defined by the API to avoid unexpected behavior.

Links and References

Discussion