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 "Homework" resource with the "List Homework" operation allows users to retrieve homework assignments within an optional date range and optionally filtered by subject.

Typical use cases include:

  • Automatically fetching homework assignments for students or parents to display in dashboards or notifications.
  • Integrating homework data into other educational tools or workflows.
  • Filtering homework by subject or date to focus on relevant tasks.

For example, a teacher could use this node to pull all homework assigned in a particular subject during a specific month, or a student could automate reminders for upcoming homework deadlines.

Properties

Name Meaning
From Optional start date (YYYY-MM-DD) to filter homework assignments from this date onward.
To Optional end date (YYYY-MM-DD) to filter homework assignments up to this date.
Custom method name Advanced: override the underlying API method called (e.g., to call a custom or new method).
Subject ID Numeric ID of the subject to filter homework; use -1 or leave empty to include all subjects.

Output

The output is an array of JSON objects, each representing a homework assignment matching the specified filters. Each object contains details about the homework such as description, due dates, subject information, and possibly other metadata returned by the Librus API.

No binary data output is produced by this operation.

Dependencies

  • Requires valid credentials for the Librus API (login and password).
  • The node uses an internal client wrapper to communicate with the Librus API.
  • No additional external services are required beyond the Librus API access.
  • Proper configuration of the API credentials in n8n is necessary.

Troubleshooting

  • No supported method found error: This occurs if the node cannot find a matching API method for the selected resource and operation. Ensure that the resource and operation names are correct and supported by the current version of the node.
  • Authentication errors: If login credentials are incorrect or expired, the node will fail to authenticate. Verify the API login and password credentials.
  • Empty results: If no homework is returned, check the date range filters and subject ID. Using overly restrictive filters may result in no data.
  • Custom method name misuse: Providing an invalid or unsupported custom method name can cause errors. Use this only if you know the exact API method to call.

Links and References


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

Discussion