Librus icon

Librus

Read data from Librus Synergia (unofficial)

Overview

This node integrates with the Librus API, a platform commonly used in educational environments for managing school-related information. The node allows users to retrieve various types of data such as messages, homework, absences, calendar events, grades, and notifications from a Librus account.

Specifically, the Info - Get Notifications operation fetches notifications related to the user’s account. This can be useful for automating workflows that need to react to new alerts or updates from the Librus system, such as notifying teachers or parents about new messages or important announcements.

Practical examples include:

  • Automatically fetching and processing new notifications to trigger alerts in other systems.
  • Integrating notification data into dashboards or reporting tools.
  • Archiving notifications for record-keeping or compliance purposes.

Properties

Name Meaning
Custom method name (Optional) Override the default Librus API method called by the node. For example, specify "getMarks" to call a different method than the default one for the selected operation.

Note: Since only the "Custom method name" property was provided for this resource-operation pair, it is the sole input property relevant here.

Output

The output is an array of JSON objects representing the notifications retrieved from the Librus API. Each object corresponds to a single notification with its associated details as returned by the API.

  • The json field contains the notification data.
  • No binary data output is expected for this operation.

Example output structure (simplified):

[
  {
    "id": "notification_id",
    "title": "Notification title",
    "content": "Notification content",
    "date": "2024-01-01T12:00:00Z",
    ...
  },
  ...
]

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 services or environment variables are explicitly required beyond the API credentials.

Troubleshooting

  • No supported method found error: If the custom method name or operation does not match any available API methods, the node will throw an error listing available methods. Ensure the operation and custom method name are correct and supported by the Librus API.
  • Authentication errors: Invalid or expired credentials will prevent successful API calls. Verify the login and password are correct.
  • Empty or unexpected results: Check date range filters if used; incorrect ranges may result in no data returned.
  • Binary data handling: Not applicable for this operation, but other operations returning files require proper binary property configuration.

Links and References

Discussion