6.1.2 Product Connector Nodes
      Back to home
      1. Home
      2. 6: Nodes Reference Guide
      3. 6.1.2 Product Connector Nodes

      QR Tiger Node Configuration Guide

      The QR Tiger Node enables direct integration with QR TIGER’s REST API to retrieve, generate, and manage dynamic QR code campaigns. It supports both input endpoints (to track usage and fetch campaign data) and output endpoints (to create/update QR)

      What It Does

      This node connects to QR TIGER’s API using your account's API key. Depending on the selected endpoint, it can:

      • Track QR code scan metrics over time (e.g., daily scan counts)

      • Retrieve a list of all configured QR code campaigns

      • Generate new dynamic QR codes with branding

      • Update the destination or appearance of existing QR codes

      The data can then be pushed into Rayven’s workflows for automation, monitoring, or visualization.

      🪜 How to Use

      Prerequisites

      • Active QR TIGER account with API access

      • Your QR TIGER API key (see below for instructions to retrieve it)

      Rayven Workflow Implementation

      Step 1: Access the Workspace

      • Go to the Workflows section in Rayven.io

      • Click Create Workflow and give it a relevant name (e.g., QR Campaign Tracker)


      Step 2: Add Input Nodes

      Choose one of the available input endpoints:

      Input Node Description
      Track Data Retrieve scan analytics for a specific QR code
      List All QR Campaigns Load all dynamic QR codes under your account
       

      Configuration for both requires:

      • API URL

      • API Key

      • QRID (for Track Data)

      • Period, Timezone, and optional triggers

      Step 3: Add Output Nodes

      Use either of the following:

      Output Node Description
      Create Dynamic QR Code Generate a new branded QR code with custom redirect
      Update QR Code Modify settings or destination for an existing QR code
       

      You may pass optional properties such as frame, qrData, grdType, and custom branding details.

      Step 4: Configure Triggers and Logic

      • Add Trigger Nodes for scheduled or conditional actions

      • Use Filter Nodes to segment campaigns (e.g., by name, scan count)

      • Use Output Nodes to push results to a dashboard or another system

      ⚙️ Node Configuration Fields

      Field Requirement Description
      Node Name* Required Internal name for the node.
      API URL Required URL for the QR TIGER API endpoint.
      API Key Required Your QR TIGER authentication token.
      QRID Optional (Track Data only) The ID of the QR campaign to track.
      Period Required (Track Data) Aggregation period. Example: Day.
      Timezone Optional Time zone to align API results.
      Trigger Optional Enable to schedule the node at defined intervals.
      Interval Between Events Optional Frequency (numeric)
      Interval Units Optional Time unit for trigger (e.g., Days)
      Trigger Using Filter Optional Filter QR code data using label rules
      Logical Operand Optional AND / OR logic for filters
      Select Data Source Filter Optional Label-based filters to scope data
       

      🎨 Customizing QR Codes via API (for Create/Update Nodes)

      You can provide additional parameters like:

      • grdType: "linear" or "radial" gradient fill

      • eye_outer, eye_inner: Corner shape settings

      • qrData: Custom path for pattern design

      • frame: Frame layout around the code

      • url: Destination link for dynamic QR codes

      These values are passed through the output node’s body configuration or mapped from incoming payloads.

      🔐 How to Get Your QR TIGER API Key

      1. Log in to QR TIGER

      2. Navigate to My Account

      3. Locate the API Key

      4. Click Copy

      5. Paste it into the API Key field in your node

      🧪 Example: Scan Analytics Tracker

      Field Value
      Node Name QR Scan Monitor
      Endpoint Track Data
      API URL https://api.qr-tiger.com/v1/track/...
      API Key •••••••
      QRID 12345abc
      Period Day
      Timezone Australia/Sydney
      Trigger Interval 1
      Interval Units Days
       

      Result: Fetches daily scan counts of a dynamic QR code and passes them into the workflow as a structured JSON object.

      🔁 Additional Endpoint Options

      If your required API method is not listed:

      • Use the HTTP Node to send custom requests to QR TIGER

      • Provide URL, headers, and method directly

      • Request new endpoint support via Rayven Support (72h turnaround)

      🎯 Example Use Case

      Scenario: Marketing wants real-time performance tracking for QR flyers.

      Solution:

      • Add List All QR Campaigns and Track Data nodes

      • Build dashboard showing:

        • Total scans

        • Scan breakdown by campaign

        • Hourly scan rates

      • Add alerting logic to trigger when scan count falls below target

      ❓ FAQ

      Q: Can I create QR codes with logos and colors?

      Yes, using the Create Dynamic QR Code node or HTTP POST, you can define styles such as gradient type, frames, and embedded logos.

      Q: What if a campaign doesn't show scan data?

      Ensure you're using a dynamic QR code with the correct QRID. Static codes cannot be tracked.

      Q: Can I filter QR campaigns by metadata?

      Yes, use filter nodes to select campaigns by name, scan count, or last activity.