Lectful icon

Lectful

Interact with the VIPay Lectful API

Overview

This node integrates with the Lectful API to manage blog-related administrative tasks, specifically for the "Get Categories (Admin)" operation under the Blog resource. It allows users with admin access to retrieve all blog categories from the Lectful platform.

Typical use cases include:

  • Fetching a list of all blog categories for display or further processing.
  • Synchronizing blog category data between Lectful and other systems.
  • Automating content management workflows that depend on blog category information.

For example, an education platform administrator might use this node to pull all blog categories to dynamically populate category filters in a custom dashboard or to update external CMS systems.

Properties

Name Meaning
Authentication Mode Choose how to authenticate with the Lectful API:
- Use Stored Credentials
- Manual Configuration
Base URL Override (Manual mode only) Optional base URL to override the credential setting (without /api/v1)
API Key Override (Manual mode only) Optional API key to override the credential setting
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 with its associated properties as returned by the API.

The exact structure depends on the Lectful API response but typically includes fields such as category ID, name, description, and possibly metadata related to the category.

No binary data output is involved in 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 missing or invalid credentials. Ensure you have configured valid API credentials or provided correct manual settings.
  • Base URL Override required in manual mode: When using manual configuration, the base URL must be specified; otherwise, the node will error out.
  • API Key Override required in manual mode: Similarly, the API key must be provided when manual mode is selected.
  • API errors: If the Lectful API returns an error (e.g., unauthorized, not found), the node will propagate the error message. Check your API key permissions and endpoint correctness.
  • Pagination limits: If the number of categories exceeds the Per Page limit, multiple calls or pagination handling may be necessary outside this node.

Links and References


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

Discussion