Apprecio icon

Apprecio

Interactúa con la API de Apprecio

Actions5

Acumulación de Puntos

AI-generated

Overview

This node integrates with the Apprecio API to manage user points and related information. It supports multiple operations such as directly loading points by email, accumulating points for an existing user, checking a user's point balance, querying batch load information, and retrieving gift card details.

A common use case is loyalty programs where businesses want to add or check points for users based on their activities or purchases. For example, you can accumulate points for a user after a purchase or check their current points balance before offering a reward.

Specifically, the "Acumulación de Puntos" operation allows accumulating a specified number of points to an existing user identified by their user ID.

Properties

Name Meaning
ID Usuario The unique identifier of the user to whom points will be accumulated. Required for "Acumulación de Puntos" and "Consulta de Saldo" operations.
Puntos The amount of points to accumulate for the user. Required only for the "Acumulación de Puntos" operation.

Output

The node outputs a JSON object containing the response from the Apprecio API for each input item processed. The structure depends on the specific operation but generally includes:

  • Confirmation or status of the points accumulation.
  • Details about the user or transaction.
  • Error messages if any issues occurred during the API call.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for authenticating with the Apprecio API.
  • Uses the Axios library for HTTP requests.
  • Requires network access to the Apprecio API endpoint (default: https://apiv2.dcanje.com/api).
  • The node internally generates a timestamp and MD5 hash for request validation using the provided public and private tokens.

Troubleshooting

  • Common Issues:

    • Invalid or missing user ID (ID Usuario) will cause the API to reject the request.
    • Incorrect points value (e.g., negative numbers) may result in errors.
    • Network connectivity problems can prevent successful API calls.
    • Expired or invalid API credentials will cause authentication failures.

  • Error Messages:

    • "Error de la API de Apprecio: <message>": Indicates the API returned an error; check the message for details such as invalid parameters or user not found.
    • "No se recibió respuesta de la API de Apprecio": Suggests a timeout or network issue; verify connectivity and API availability.
    • "Error al realizar la solicitud: <message>": General request failure; review the error message for specifics.

To resolve these errors, ensure all required parameters are correctly set, credentials are valid, and the API service is reachable.

Links and References

Discussion