LibrusInstall

Overview

This node integrates with the Librus API, a platform commonly used by schools for managing student information such as homework, absences, messages, and calendars. The "Get Absences" operation under the "Homework" resource retrieves absence records from the user's account.

Typical use cases include:

• Automatically fetching student absence data within a specified date range.
• Integrating absence records into other systems like school management software or reporting tools.
• Monitoring attendance trends over time.

For example, a teacher or school administrator could use this node to pull all absences between two dates to generate attendance reports or trigger notifications for prolonged absences.

Properties

Output

The node outputs an array of JSON objects representing absence records. Each object corresponds to an individual absence entry retrieved from the Librus API.

• The exact structure of each absence record depends on the API response but typically includes details such as absence date, type, justification status, and related metadata.
• No binary data output is produced by this operation.

Example output snippet (simplified):

[
  {
    "date": "2024-05-01",
    "type": "excused",
    "justified": true,
    "notes": "Medical certificate provided"
  },
  {
    "date": "2024-05-03",
    "type": "unexcused",
    "justified": false,
    "notes": ""
  }
]

Dependencies

• Requires valid credentials for the Librus API (login and password).
• The node uses an internal client wrapper to communicate with the Librus API.
• No additional external services are required beyond the Librus platform.
• Proper configuration of the API credentials in n8n is necessary for authentication.

Troubleshooting

• No supported method found error: This occurs if the node cannot find a matching API method for the selected resource and operation. Ensure that the resource is set to "Homework" and operation to "Get Absences". If using a custom method name, verify it matches a valid Librus API method.
• Authentication failures: Check that the provided login and password credentials are correct and have sufficient permissions.
• Empty results: If no absences are returned, verify the date filters ("From" and "To") are correctly set and that there are absences recorded in that period.
• Date format issues: Dates must be in YYYY-MM-DD format. Incorrect formatting may cause filtering to fail or return unexpected results.

Links and References

• Librus Official Website — For general platform information.
• Librus API Documentation — (If available) Reference for API methods and data structures.
• n8n Documentation on Credentials — How to configure API credentials securely.