Lectful icon

Lectful

Interact with the VIPay Lectful API

Overview

This node integrates with the Lectful API to manage educational content and user-related data. Specifically, for the Article resource with the Get All operation, it retrieves a list of all articles available in the Lectful system.

Typical use cases include:

  • Fetching all articles to display or process them in workflows.
  • Synchronizing article data from Lectful into other systems.
  • Automating content management tasks involving articles.

Example: A user might want to pull all articles to generate a report or update a CMS with the latest article content.

Properties

Name Meaning
Authentication Mode Choose how to authenticate with the Lectful API:
- Use Stored Credentials
- Manual Configuration
Credentials Note Notice shown when using Manual Configuration mode explaining credential overrides
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

These properties control how the node authenticates with the Lectful API. For the Article - Get All operation, no additional parameters are required.

Output

The node outputs an array of JSON objects representing articles retrieved from the Lectful API.

  • The json field contains the raw response data from the API call to /admin/articles.
  • Each item corresponds to an article object as returned by Lectful, typically including fields like article ID, title, content, metadata, etc.

No binary data is output for this operation.

Dependencies

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

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.
  • Base URL Override required in manual mode: When using manual authentication mode, both Base URL Override and API Key Override must be provided; otherwise, an error is thrown.
  • API errors: Any HTTP errors from the Lectful API (e.g., 401 Unauthorized, 403 Forbidden) will be surfaced as errors in the node execution.
  • Parsing errors: If the API returns non-JSON or malformed responses, the node attempts to parse but may fail, resulting in errors.

To resolve issues:

  • Verify credentials and API key validity.
  • Ensure correct base URL format without trailing /api/v1.
  • Check API permissions for the used API key.
  • Enable "Continue On Fail" in the node settings to handle errors gracefully in workflows.

Links and References


Note: This summary focuses exclusively on the Article resource with the Get All operation as requested.

Discussion