Toolzz Dificulties

Overview

The Toolzz Dificulties node is designed to retrieve a list of "difficulties" from the Toolzz API for a specified institution. It performs an HTTP GET request to the Toolzz API endpoint, using the provided institution URL and selected environment (currently only "Prod" is available). This node is useful in scenarios where you need to fetch or synchronize difficulty-related data from Toolzz into your n8n workflows, such as populating dropdowns, validating user input, or integrating with other educational tools.

Practical Example:
You might use this node to automatically fetch and display all available difficulties for courses at a given institution, enabling dynamic form options or automated reporting.

Properties

Output

The node outputs a JSON array containing the response from the Toolzz API's /search/filters/dificulties endpoint. The exact structure depends on the API response, but typically it will be an array of objects representing different difficulties.

Example output:

[
  {
    "id": 1,
    "name": "Beginner",
    "description": "Suitable for beginners"
  },
  {
    "id": 2,
    "name": "Intermediate",
    "description": "Requires some prior knowledge"
  }
]

Note: The actual fields depend on the Toolzz API.

Dependencies

• External Service: Requires access to the Toolzz API at https://gateway.api.toolzz.com.br.
• No authentication credentials are configured in this node.
• n8n Configuration: No special configuration required beyond network access to the API endpoint.

Troubleshooting

• Common Issues:

  • Invalid or missing "Url of Institution": If the URL is incorrect or empty, the API may return errors or no data.
  • Network Errors: If n8n cannot reach the Toolzz API (e.g., due to firewall or DNS issues), the node will fail.
  • API Changes: If the Toolzz API changes its response format or endpoint, the node may not function as expected.

• Error Messages:

  • "Request failed with status code 404": The endpoint does not exist or the institution URL is invalid. Check the "Url of Institution" property.
  • "Request failed with status code 401/403": Access denied. Although this node does not require credentials, ensure the API is publicly accessible or update the node if authentication becomes necessary.
  • "ENOTFOUND" or "ECONNREFUSED": Network connectivity issue. Verify that the n8n instance can reach the Toolzz API server.

Links and References

• Toolzz API Documentation (if available)
• n8n Documentation: Creating Custom Nodes