Librus icon

Librus

Read data from Librus Synergia (unofficial)

Overview

This node integrates with the Librus API, a platform commonly used by schools for managing educational data. Specifically, the "Get Homework" operation under the "Homework" resource retrieves detailed information about a particular homework assignment identified by its ID.

Typical use cases include:

  • Fetching details of a specific homework task to display or process in an automated workflow.
  • Integrating homework data into other systems such as calendars, notification services, or reporting tools.
  • Automating reminders or follow-ups based on homework assignments.

For example, a teacher could automate sending notifications to students about upcoming homework deadlines by retrieving homework details through this node.

Properties

Name Meaning
From Optional start date filter (format: YYYY-MM-DD) to limit data retrieval by date range.
To Optional end date filter (format: YYYY-MM-DD) to limit data retrieval by date range.
Custom method name Advanced option to override the default API method called; e.g., specify another method like getMarks.
Homework ID The unique numeric identifier of the homework assignment to retrieve. (Required)

Note: For the "Get Homework" operation, only the "Homework ID" is strictly required. The "From", "To", and "Custom method name" properties are available but may not affect this specific operation.

Output

The node outputs JSON data representing the homework details fetched from the Librus API. The structure corresponds directly to the API response for a single homework item, typically including fields such as title, description, due date, subject, and any associated metadata.

If multiple items were returned (not typical for this operation), each would be output as a separate JSON object in the array.

No binary data output is produced by this operation.

Dependencies

  • Requires valid credentials for the Librus API, specifically a login and password.
  • The node uses an internal client wrapper to communicate with the Librus API.
  • No additional external dependencies beyond the configured API credentials.

Troubleshooting

  • Error: No supported method found for resource "Homework"
    This indicates that the underlying API client does not have a callable method matching the requested operation. Ensure the operation name is correct and supported by the current version of the API client.

  • Authentication failures
    Verify that the provided API credentials (login and password) are correct and have sufficient permissions.

  • Invalid Homework ID
    If the homework ID does not exist or is invalid, the API may return an error or empty response. Confirm the ID before running the node.

  • Date filters ignored
    The "From" and "To" date filters do not apply to the "Get Homework" operation since it fetches a single item by ID.

Links and References


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

Discussion