Toolzz Painel Performace User icon

Toolzz Painel Performace User

Get Painel User of Toolzz API

Overview

This node, Toolzz Painel Performace User, retrieves user performance data from the Toolzz API for a specified "Item Painel" (panel item). It is useful in scenarios where you need to fetch and process performance history for users within the Toolzz platform, such as generating reports, monitoring progress, or integrating this data into other workflows.

Practical examples:

  • Fetching a user's performance metrics for a specific panel item to display in dashboards.
  • Automating periodic checks of user performance for compliance or analytics.
  • Integrating Toolzz performance data with other educational or business intelligence tools.

Properties

Name Type Meaning
AccessToken String The authentication token required to access the Toolzz API.
Item Painel ID String The unique identifier of the panel item whose performance data you want to retrieve.
Ambiente Options The environment (API base URL) to use: Prod, Homol, or Release. Selects the API server.

Output

The node outputs a JSON array containing the performance data retrieved from the Toolzz API endpoint /api/history/performace{itemId}. The exact structure of each object in the array depends on the API response, but typically includes fields relevant to user performance for the specified panel item.

Example output (structure may vary):

[
  {
    "userId": "12345",
    "score": 87,
    "completedAt": "2024-06-01T12:34:56Z",
    // ...other performance-related fields
  }
]

Dependencies

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

Troubleshooting

  • Invalid AccessToken: If the AccessToken is missing or invalid, the API will likely return an authentication error (e.g., 401 Unauthorized). Ensure the token is correct and has not expired.
  • Incorrect Item Painel ID: Providing an incorrect or non-existent Item Painel ID may result in empty responses or 404 errors.
  • Environment Selection: Choosing the wrong Ambiente (environment) could lead to unexpected data or connection failures if the environment is down or inaccessible.
  • Common Error Messages:
    • 401 Unauthorized: Check your AccessToken.
    • 404 Not Found: Verify the Item Painel ID and the selected environment.
    • Network Error: Ensure the n8n instance can reach the selected API URL.

Links and References

Discussion