Overview
This node integrates with the Apprecio API to perform various operations related to user points management. Specifically, for the "Consulta de Saldo" operation, it allows querying the current points balance of a specified user by their user ID.
Common scenarios where this node is beneficial include loyalty programs or reward systems where businesses need to check users' accumulated points before allowing redemptions or further point transactions. For example, a marketing automation workflow could use this node to verify a customer's points balance before sending personalized offers.
Properties
| Name | Meaning |
|---|---|
| ID Usuario | The unique identifier of the user whose points balance will be queried. |
Output
The node outputs a JSON object containing the response from the Apprecio API regarding the user's points balance. The exact structure depends on the API but typically includes fields such as the user's current points total and possibly additional metadata about the account status.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authenticating with the Apprecio API.
- Uses the Apprecio API endpoint (default:
https://apiv2.dcanje.com/api). - Relies on generating an MD5 hash signature combining a public token, private token, and timestamp for request validation.
- Uses multipart/form-data POST requests to communicate with the API.
Troubleshooting
- API Errors: If the API returns an error message, it will be surfaced prefixed with "Error de la API de Apprecio". This usually indicates issues like invalid user ID, expired tokens, or malformed requests.
- No Response: If no response is received from the API, the node throws an error indicating a connectivity or server issue.
- Unsupported Operation: Attempting to use an unsupported operation value will result in an explicit error.
- Credential Issues: Ensure that the required API credentials (public and private tokens) are correctly configured in n8n; missing or incorrect credentials will cause authentication failures.
Links and References
- Apprecio API Documentation (assumed base URL, consult actual docs for details)
- MD5 Hashing Algorithm
- n8n Documentation - Creating Custom Nodes