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 student information, messages, homework, absences, calendars, and grades. The node allows users to perform various operations on different resources such as retrieving inbox messages, getting grades, listing homework, and more.

The Info - List Inbox operation specifically fetches the list of inbox messages from the user's Librus account. It supports filtering messages by date range and pagination, making it useful for automating message retrieval, notifications, or further processing of school communications.

Practical examples:

  • Automatically fetching new messages from the school inbox to trigger alerts or workflows.
  • Archiving or analyzing received messages over a specific period.
  • Integrating school communication into other systems like email or chat platforms.

Properties

Name Meaning
Custom method name (Optional) Override the default underlying API method to call (e.g., getMarks). If set, this custom method will be called instead of the standard one for the selected operation.

Note: Although only the "Custom method name" property is provided here, the node internally uses many other parameters depending on the resource and operation, such as folder ID, page number, message ID, date ranges, etc. For the Info - List Inbox operation, relevant parameters include:

  • Date range filters (from, to) to limit messages by date.
  • Pagination parameters (page).
  • Folder ID to specify which inbox folder to query.

Output

The output is an array of JSON objects representing the inbox messages retrieved from the Librus API. Each object corresponds to a single message with its associated data fields as returned by the API.

If the operation involves fetching binary files (not applicable for List Inbox), the node outputs binary data encoded in base64 under a specified binary property.

For List Inbox, the output structure is:

[
  {
    "json": {
      /* message properties such as sender, subject, content, date, etc. */
    }
  },
  ...
]

Dependencies

  • Requires valid credentials for the Librus API (login and password).
  • Uses an internal client wrapper to communicate with the Librus API.
  • Supports optional date filtering and pagination parameters.
  • No external environment variables are explicitly required beyond the API credentials.

Troubleshooting

  • No supported method found error: This occurs if the selected resource-operation combination does not map to any available API method. Ensure that the resource and operation names are correct and supported by the node.
  • Authentication errors: Invalid or missing credentials will prevent API access. Verify that the login and password are correctly configured.
  • Empty results: If no messages appear, check the date range filters and folder ID parameters to ensure they match existing inbox contents.
  • Pagination issues: If too few or too many messages are returned, adjust the page parameter accordingly.

Links and References

Discussion