Lectful icon

Lectful

Interact with the VIPay Lectful API

Overview

This node integrates with the Lectful API to manage blog-related data in an administrative context. Specifically, the "Get Tags (Admin)" operation retrieves all blog tags available through the admin interface of the Lectful platform.

Use cases for this node include:

  • Fetching a list of all blog tags to display or use in content management workflows.
  • Automating blog tag synchronization between Lectful and other systems.
  • Enabling dynamic filtering or categorization of blog posts based on tags within automation workflows.

Example scenario: An organization wants to regularly update their internal CMS with the latest blog tags from Lectful to maintain consistency across platforms. This node can be used to fetch those tags automatically.

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)
Credentials Note Informational note shown when using Manual Configuration mode explaining credential usage.
Base URL Override Optional base URL to override the stored credential's base URL (exclude /api/v1).
API Key Override Optional API key to override the stored credential's API key.
Per Page Number of tags to retrieve per page (default is 20).

Output

The output is a JSON array containing the retrieved blog tags. Each item in the array represents a blog tag object as returned by the Lectful API's admin endpoint for tags. The exact structure depends on the API but typically includes fields such as tag ID, name, and possibly metadata related to the tag.

No binary data is output by this operation.

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 node uses HTTP requests with Bearer token authentication to communicate with the Lectful API.

Troubleshooting

  • Missing or invalid credentials: If neither stored credentials nor manual overrides are provided correctly, the node will throw an error indicating that valid credentials are required.
  • Base URL Override missing in manual mode: When using manual configuration, the base URL override must be provided; otherwise, an error is thrown.
  • API Key Override missing in manual mode: Similarly, the API key override must be provided in manual mode.
  • API errors: Errors returned by the Lectful API (e.g., unauthorized, not found) will be surfaced as node execution errors.
  • Pagination limits: If the number of tags exceeds the Per Page limit, multiple executions or pagination handling may be necessary.

Links and References


This summary focuses exclusively on the "Blog" resource and the "Get Tags (Admin)" operation as requested.

Discussion