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. It allows users to retrieve various types of information such as messages, homework, absences, calendar events, grades, notifications, and account info. The node is useful for automating workflows that involve accessing or processing school-related data from Librus, such as fetching a list of subjects, retrieving homework assignments, or getting notifications.

For example, in the "List Subjects" operation under the "Info" resource, the node fetches all subjects associated with the user’s account, which can then be used in further automation steps like generating reports or syncing with other systems.

Properties

Name Meaning
Custom method name Advanced: override the underlying Librus API method to call (e.g., getMarks). If empty, the default method for the selected operation is used.

Note: Although many parameters are retrieved internally for different operations, only the above property is exposed based on your input.

Output

The output is an array of JSON objects representing the data returned by the Librus API for the selected operation. For the "List Subjects" operation under the "Info" resource, the output will be a JSON array where each element corresponds to a subject with its details as provided by the API.

If the operation involves binary data (e.g., downloading a file), the node outputs a binary property containing the file data encoded in base64 along with metadata such as MIME type and filename.

Dependencies

  • Requires valid credentials for the Librus API (login and password).
  • Uses an internal client wrapper to communicate with the Librus API.
  • No additional external dependencies beyond the configured API credentials.

Troubleshooting

  • No supported method found error: This occurs if the node cannot find a matching API method for the selected resource and operation. Ensure the resource and operation names are correct and supported by the node.
  • Authentication errors: Verify that the provided login credentials are correct and have sufficient permissions.
  • Empty or unexpected results: Check date range filters or other parameters that might limit the returned data.
  • Binary data handling: When downloading files, ensure the binary property name is correctly set to avoid missing attachments.

Links and References

  • Librus Official Website (for general platform info)
  • Documentation or API references for Librus (if available publicly) would be helpful but are not included here due to lack of source code comments.

Discussion