Toolzz Show Percentage School icon

Toolzz Show Percentage School

Get Percentage the School of Toolzz API

Overview

The Toolzz Show Percentage School node retrieves the percentage-related statistics for a specific school from the Toolzz API. It is designed to fetch data about a school's performance or engagement metrics, as provided by the Toolzz platform.

Common scenarios:

  • Integrating school performance data into automated workflows.
  • Generating reports or dashboards based on school-specific statistics.
  • Triggering actions in n8n based on certain thresholds of school performance.

Practical example:
A user could use this node to automatically collect and aggregate percentage-based metrics (such as completion rates or participation percentages) for a given school, then send notifications or update records in other systems.

Properties

Name Type Meaning
AccessToken String The authentication token required to access the Toolzz API.
Ambiente Options The environment to connect to (Prod, Homol, Release). Selects the API base URL.
ID Da Escola String The unique identifier of the school whose percentage data will be retrieved.

Output

The node outputs a JSON object containing the percentage data for the specified school, as returned by the Toolzz API endpoint /api/reports/school/{school_id}/percentage.

Output structure:

  • The exact fields depend on the Toolzz API response, but typically include keys representing various percentage metrics related to the school.
{
  "somePercentageMetric": 85,
  "anotherMetric": 42
  // ...other fields as defined by the API
}

Note: The node does not output binary data.

Dependencies

  • External Service: Requires access to the Toolzz API.
  • API Key: A valid AccessToken must be provided.
  • Network Access: The selected environment (Ambiente) must be reachable from the n8n instance.

Troubleshooting

Common issues:

  • Invalid AccessToken: If the token is missing or incorrect, the API will likely return an authentication error (e.g., 401 Unauthorized).
  • Incorrect School ID: Providing a non-existent or invalid school ID may result in a 404 Not Found or similar error.
  • Environment Unreachable: If the selected Ambiente URL is down or unreachable, requests will fail with network errors.

Error messages and resolutions:

  • "401 Unauthorized": Check that the AccessToken is correct and has not expired.
  • "404 Not Found": Verify that the ID Da Escola matches a valid school in the Toolzz system.
  • "ENOTFOUND" or "ECONNREFUSED": Ensure the Ambiente URL is correct and accessible from your n8n server.

Links and References

Discussion