Librus icon

Librus

Read data from Librus Synergia (unofficial)
Join our community

Actions105

Overview

This node integrates with the Librus API, a platform commonly used by schools for managing educational data. It allows users to retrieve various types of information such as homework assignments, messages, absences, calendar events, grades, notifications, and account details. The "Get Homework" operation under the "Info" resource specifically fetches detailed information about a particular homework entry by its identifier.

Typical use cases include:

  • Automatically fetching and processing homework details for students or teachers.
  • Integrating homework data into other workflows like reminders, reporting, or analytics.
  • Combining homework information with other educational data (grades, absences) for comprehensive student monitoring.

Properties

Name Meaning
Custom method name Advanced: override the underlying Librus API method to call (e.g., getMarks). If set, this custom method is called instead of the default one for the operation.

Note: Although only the "Custom method name" property is defined here, the node internally supports many other parameters depending on the resource and operation selected (e.g., IDs, date ranges, pagination), but these are not exposed in this summary since the focus is on the "Info" resource and "Get Homework" operation.

Output

The output JSON structure depends on the specific operation invoked. For the "Get Homework" operation, the node returns a JSON object representing the detailed homework data retrieved from the Librus API. This typically includes fields such as homework description, due dates, subject, and any other metadata provided by the API.

If the result is an array (not typical for "Get Homework"), each element is returned as a separate item in the output array.

The node can also handle binary data outputs for certain operations (e.g., downloading message attachments), but this does not apply to the "Get Homework" operation.

Dependencies

  • Requires valid credentials for the Librus API (login and password).
  • Uses an internal client wrapper around the Librus API to perform calls.
  • No additional external services or environment variables are explicitly required beyond the API credentials.

Troubleshooting

  • No supported method found error: If the node throws an error indicating no supported method was found for the resource-operation combination, verify that the operation name matches exactly and that the API credentials have sufficient permissions.
  • Empty or unexpected results: Check if the homework ID provided exists and is accessible with the given credentials.
  • Date filtering issues: Some operations support filtering by date range; ensure date formats are correct and consistent.
  • Binary data handling: For operations returning files, ensure the binary property name is correctly set to avoid missing file data.

Links and References

Discussion