Librus icon

Librus

Read data from Librus Synergia (unofficial)

Overview

This node integrates with the Librus API, a platform commonly used in educational settings for managing school-related data. The node allows users to retrieve various types of information such as account details, grades, notifications, messages, homework, absences, calendar events, and more. It is particularly useful for automating workflows that involve accessing or processing student or teacher data from Librus.

For the Info resource with the Get Account Info operation, the node fetches detailed account information about the authenticated user. This can be beneficial for scenarios where you want to verify user identity, display profile details, or use account metadata in subsequent workflow steps.

Practical Examples

  • Automatically retrieving and displaying a user's account info upon login.
  • Using account info to personalize notifications or reports.
  • Integrating Librus account data into other school management systems or dashboards.

Properties

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

Note: Although only one property is listed here for the Info - Get Account Info operation, the node supports many other parameters for different resources and operations, but they are not relevant here.

Output

The output is a JSON object containing the account information retrieved from the Librus API. The exact structure depends on the API response but typically includes user profile details such as name, role, contact information, and other metadata related to the account.

  • The output is returned as an array of items, each with a json field holding the account info object.
  • No binary data is produced for this operation.

Example output snippet (conceptual):

[
  {
    "json": {
      "userId": "12345",
      "name": "John Doe",
      "role": "Student",
      "email": "john.doe@example.com",
      ...
    }
  }
]

Dependencies

  • Requires valid credentials with login and password for the Librus API.
  • Uses an internal client wrapper to communicate with the Librus API.
  • No additional external services beyond the Librus API itself.
  • The node expects proper configuration of these credentials within n8n.

Troubleshooting

  • No supported method found error: If the node throws an error indicating no supported method was found for the resource-operation combination, ensure that:

    • The resource and operation names are correctly set.
    • The custom method name (if provided) matches an existing method in the API client.
    • Credentials are valid and have sufficient permissions.
  • Authentication failures: Verify that the login and password credentials are correct and active.

  • Empty or unexpected output: Check date range filters or other parameters that might limit the returned data.

  • Binary data handling: For operations returning files (not applicable here), ensure the binary property name is correctly set.

Links and References

Discussion