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. Specifically, the "Calendar" resource with the "List Subjects" operation fetches the list of subjects related to homework assignments from the user's account.

Typical use cases include:

  • Retrieving all subjects to display or process homework assignments.
  • Automating workflows that depend on subject information, such as sending reminders or generating reports.
  • Integrating school calendar data into other systems or dashboards.

For example, a teacher could use this node to automatically pull their current subjects and then trigger further actions like fetching homework details or scheduling events.

Properties

Name Meaning
Custom method name (Optional) Override the default underlying API method called for this operation. For example, specify a different method name like getMarks to customize behavior.

Output

The output is a JSON array where each item represents a subject retrieved from the Librus API's homework subjects list. Each subject object contains properties as returned by the API, typically including identifiers, names, and possibly additional metadata about the subject.

No binary data is produced by this operation.

Example output structure (simplified):

[
  {
    "id": "subject-id-1",
    "name": "Mathematics",
    "teacher": "John Doe"
  },
  {
    "id": "subject-id-2",
    "name": "History",
    "teacher": "Jane Smith"
  }
]

Dependencies

  • Requires valid credentials for the Librus API (login and password).
  • Depends on the external librus-api client library wrapped inside the node.
  • No additional environment variables are needed beyond the credentials configured in n8n.

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 is set to "Calendar" and operation to "List Subjects" (which maps internally to homework.listSubjects). If using a custom method name, verify it exists in the API client.
  • Authentication errors: Verify that the provided login and password credentials are correct and have sufficient permissions.
  • Empty results: If no subjects are returned, confirm that the user account has assigned subjects and that the API service is operational.
  • Date filtering issues: Although not directly relevant to this operation, some operations support date range filters; ensure date formats are correct if used elsewhere.

Links and References

Discussion