Lectful icon

Lectful

Interact with the VIPay Lectful API

Actions88

Overview

This node integrates with the Lectful API to manage blog-related data, specifically for the "Get Categories (Public)" operation under the Blog resource. It fetches a paginated list of public blog categories from the Lectful platform. This is useful for workflows that need to display or process blog category information publicly available on a Lectful-powered site.

Typical use cases include:

  • Displaying blog categories on a website or app.
  • Synchronizing blog categories with other content management systems.
  • Automating marketing or content workflows based on blog categories.

For example, you might use this node to retrieve all public blog categories and then trigger further actions like sending newsletters or updating a category list in another system.

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 about credential usage.
Base URL Override Optional base URL to override the stored credential's base URL (without /api/v1).
API Key Override Optional API key to override the stored credential's API key.
Per Page Number of categories to retrieve per page (default is 20).

Output

The node outputs an array of JSON objects representing the blog categories retrieved from the Lectful API. Each object corresponds to a blog category and contains fields as returned by the API, typically including category ID, name, description, and other metadata.

No binary data output is produced by this operation.

Example output structure (simplified):

[
  {
    "id": 1,
    "name": "Technology",
    "description": "Posts related to technology trends and news",
    ...
  },
  {
    "id": 2,
    "name": "Education",
    "description": "Educational resources and articles",
    ...
  }
]

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 access public blog category data.
  • No additional external dependencies beyond standard HTTP requests.

Troubleshooting

  • Missing or invalid credentials: If neither stored credentials nor manual configuration is properly set, the node will throw an error indicating missing authentication details. Ensure credentials are correctly configured or manual parameters are provided.
  • Base URL Override required in manual mode: When using manual authentication mode, the base URL override must be provided; otherwise, an error is thrown.
  • API errors: If the API returns an error (e.g., rate limiting, invalid API key), the node will surface the error message. Verify API key validity and permissions.
  • Empty or unexpected response: Check if the Per Page parameter is set appropriately and that the API endpoint is accessible.

Links and References

  • Lectful API Documentation (general reference for API endpoints)
  • n8n documentation on HTTP Request Node for understanding request handling
  • Lectful blog API endpoints (public) - typically /blog/categories with optional query parameters for pagination

Discussion