Mallabe Barcodes icon

Mallabe Barcodes

Mallabe Barcodes is a utility tool that allows the generation & scanning of different barcodes, such as the popular QR code, UPC, EAN & others.

Actions3

Overview

This node, named "Mallabe Barcodes," provides functionality to generate and scan various types of barcodes, including QR codes. Specifically, the Generate QR Code operation creates a QR code image from a given message string. Users can specify the size of the QR code and choose whether to download the generated image or receive a link to it. Optionally, a webhook URL can be provided to receive the generated data asynchronously.

Common scenarios where this node is useful include:

  • Creating QR codes for URLs, contact information, or any text to embed in marketing materials.
  • Automating QR code generation in workflows for event tickets, product labels, or authentication tokens.
  • Integrating with other systems by sending the generated QR code data to a webhook.

Example: Generate a medium-sized QR code encoding a URL, then download the image directly into the workflow for further processing or storage.

Properties

Name Meaning
Message The text or data string to encode into the QR code.
Size The size of the QR code image to generate. Options: Large, Medium, Small.
Download Image? Whether to download the QR code image as binary data (true) or just return a link (false).
Put Output File In Field When downloading the image, the name of the output field where the binary file will be stored.
Webhook URL (Optional) An optional URL to which the generated QR code data will be sent after creation.

Output

The node outputs JSON data containing details about the generated QR code. If the Download Image? property is set to false, the output JSON includes a URL pointing to the generated QR code image.

If Download Image? is true, the node downloads the QR code image and outputs it as binary data under the specified output field name. The output structure in this case is:

{
  "json": {
    // JSON response from the API including metadata and URL
  },
  "binary": {
    "<outputFieldName>": {
      "data": "<base64-encoded image data>",
      "mimeType": "image/png"
    }
  }
}

Where <outputFieldName> is the user-defined field name for the binary data.

Dependencies

  • Requires an active API key credential for the Mallabe Barcodes service.
  • The node makes HTTP POST requests to the Mallabe Barcodes API endpoints to generate QR codes.
  • If downloading images, the node fetches the image data from a CDN URL provided by the API.
  • Optional webhook URL support requires that the user has a publicly accessible endpoint to receive callbacks.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication errors.
    • Providing an empty or invalid message string may result in API errors or empty QR codes.
    • Incorrect webhook URLs might lead to failed callbacks or no data received.
    • Network connectivity problems can prevent API calls or image downloads.

  • Error messages:

    • Authentication failures: Check that the API key credential is correctly configured.
    • Validation errors on input parameters: Ensure required fields like "Message" and "Size" are properly set.
    • Download failures: Verify that the CDN URL is accessible and the node has internet access.

  • Resolutions:

    • Double-check all required inputs before execution.
    • Confirm API credentials and permissions.
    • Test webhook URLs independently to ensure they accept incoming POST requests.
    • Enable "Continue On Fail" in the node settings to handle errors gracefully during batch executions.

Links and References

Discussion