Apprecio icon

Apprecio

Interactúa con la API de Apprecio

Overview

This node integrates with the Apprecio API to manage user points and related information. Specifically, the "Carga Directa Email" operation allows you to directly load points into a user's account using their email address. This is useful in scenarios such as rewarding customers, correcting point balances, or manually adjusting points for specific users.

Practical examples:

  • A loyalty program administrator wants to credit bonus points to a user who contacted support.
  • Automatically adding promotional points to users identified by their email after a marketing campaign.
  • Manually correcting points for a user due to an error in previous transactions.

Properties

Name Meaning
Email The email address of the user to whom points will be credited.
Monto The amount (number) of points to add to the user's account.
Motivo The reason or description explaining why the points are being added.

Output

The node outputs JSON data returned from the Apprecio API corresponding to the requested operation. For the "Carga Directa Email" operation, the output JSON contains the API response confirming the success or failure of the points loading action.

The output structure is:

{
  "json": {
    // API response fields, e.g. status, message, updated user info, etc.
  },
  "pairedItem": {
    "item": <index_of_input_item>
  }
}

No binary data is produced by this node.

Dependencies

  • Requires an active connection to the Apprecio API endpoint (default: https://apiv2.dcanje.com/api).
  • Needs credentials including a public token and private token for authentication.
  • Uses HTTP POST requests with multipart/form-data encoding.
  • Requires n8n credential configuration to provide the necessary API tokens.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Incorrect email format or non-existent user emails may result in API errors.
    • Network connectivity problems can prevent reaching the Apprecio API.
  • Error messages:

    • "Error de la API de Apprecio: <message>": Indicates the API responded with an error; check the message for details such as invalid parameters or authorization issues.
    • "No se recibió respuesta de la API de Apprecio": The request was sent but no response was received; verify network connectivity and API availability.
    • "Error al realizar la solicitud: <message>": General request error, possibly due to misconfiguration or unexpected issues.

To resolve errors, ensure correct API credentials, validate input parameters, and confirm network access to the API endpoint.

Links and References

Discussion