Overview
This node allows users to make custom requests to the Talenta API using HMAC authentication. It supports multiple actions related to employee data and overtime requests, such as retrieving all employees, fetching a specific employee by ID, listing overtime requests for a user, and getting details of a specific overtime request.
Common scenarios where this node is beneficial include:
- Integrating Talenta HR data into workflows for reporting or automation.
- Fetching employee lists or details dynamically based on workflow inputs.
- Managing and reviewing overtime requests programmatically.
Practical examples:
- Automatically retrieve all employees and update an internal database.
- Get detailed information about a particular employee when triggered by an event.
- List overtime requests for a user in a given month and year to generate payroll reports.
Properties
| Name | Meaning |
|---|---|
| Action | The operation to perform. Options: "Get All Employees", "Get Employee by ID", "Get Overtime Request List", "Get Overtime Request Detail by ID". |
| Return All | Whether to return all results or only up to a given limit (only shown for actions supporting pagination: "Get All Employees", "Get Overtime Request List"). |
| ID | The employee ID to fetch (used with "Get Employee by ID" action). |
| User ID | The user ID associated with overtime requests (used with "Get Overtime Request List" and "Get Overtime Request Detail by ID"). |
| Limit | Maximum number of results to return per page (used with paginated actions). |
| Page | Page number to retrieve (used with paginated actions). |
| Status | Filter results by status (used with "Get All Employees" and "Get Overtime Request List"). |
| Year | Year filter for overtime requests (used with "Get Overtime Request List"). |
| Month | Month filter for overtime requests (used with "Get Overtime Request List"). |
| Request ID | Specific overtime request ID to get details for (used with "Get Overtime Request Detail by ID"). |
Output
The node outputs JSON data representing the response from the Talenta API for the selected action:
- For list actions ("Get All Employees", "Get Overtime Request List"), it returns an array of objects, each representing an employee or an overtime request respectively.
- For detail actions ("Get Employee by ID", "Get Overtime Request Detail by ID"), it returns a single object with detailed information.
- If no list data is found, it returns the raw response wrapped in a JSON object.
The node does not output binary data.
Dependencies
- Requires an API key credential for Talenta API with HMAC authentication (client ID and client secret).
- Uses the Talenta API base URL configured in credentials.
- Relies on n8n's HTTP request helper with authentication support.
- Uses
crypto-jslibrary for HMAC SHA256 signature generation.
Troubleshooting
- Authentication errors: Ensure that the API credentials (client ID and client secret) are correctly set up and valid.
- Invalid parameters: Check that required parameters like IDs and user IDs are provided and correctly formatted.
- Pagination issues: When using "Return All", large datasets may take longer to fetch; verify limits and pages are set properly.
- API rate limits or network errors: These will throw errors with detailed request info; check connectivity and API usage quotas.
- Empty responses: May indicate no matching data for filters like status, year, or month; verify input values.
If an error occurs, the node throws a detailed error including the request line, date, signature, headers, URL, and body for easier debugging.