Lectful icon

Lectful

Interact with the VIPay Lectful API

Overview

This node interacts with the Lectful API to manage video-related operations within an educational or content management platform. Specifically, the Get Upload URL operation generates a signed URL that allows clients to upload a new video file securely.

Typical use cases include:

  • Preparing to upload a new video by obtaining a secure, time-limited URL where the video file can be uploaded.
  • Integrating video upload workflows in automated pipelines, such as uploading course videos or lecture recordings.
  • Managing video assets programmatically without manual intervention in the Lectful platform.

For example, before uploading a video file named my-video.mp4, this node can be used to request an upload URL from Lectful, which can then be used by other tools or services to perform the actual file upload.

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 (without /api/v1).
API Key Override Optional API key to override the stored credential's API key.
Filename The original filename of the video to be uploaded (e.g., my-video.mp4). Required.

Output

The node outputs a JSON object containing the response from the Lectful API for the upload URL request. This typically includes:

  • A signed URL where the video file can be uploaded securely.
  • Possibly additional metadata related to the upload session.

The exact structure depends on the Lectful API response but generally provides all necessary information to proceed with the video upload.

No binary data is output by this operation.

Example output JSON snippet (illustrative):

{
  "uploadUrl": "https://lectful-storage.example.com/upload/abc123?signature=xyz",
  "expiresIn": 3600,
  "videoId": "12345"
}

Dependencies

  • Requires access to the Lectful API.
  • Authentication can be provided either via stored credentials configured in n8n or manually by specifying the base URL and API key.
  • The node uses HTTP requests with bearer token authentication.
  • No additional external dependencies beyond standard HTTP client capabilities.

Troubleshooting

  • Missing or invalid credentials:
    If neither stored credentials nor manual overrides are properly set, the node will throw an error indicating missing or invalid credentials. Ensure you have configured your API key and base URL correctly.

  • Base URL or API key not provided in Manual mode:
    When using Manual Configuration, both Base URL Override and API Key Override must be provided; otherwise, the node will error out.

  • Invalid filename parameter:
    The filename must be a valid string representing the video file name. Omitting or providing an empty filename will cause the node to fail.

  • API errors:
    Any errors returned by the Lectful API (e.g., unauthorized, bad request) will be surfaced by the node. Check the API key validity and request parameters.

  • Network issues:
    Connectivity problems to the Lectful API endpoint will result in request failures. Verify network access and endpoint availability.

Links and References


If you need details on other operations or resources, feel free to ask!

Discussion