Validate QR Code Info Data

Validate QR content against a category schema

curl --request POST \
  --url https://api.scanova.io/qr/validate-info/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "info": "{\"type\":\"url\",\"data\":{\"url\":\"https://example.com/summer-sale\"}}",
  "category": 3
}
'

import requests

url = "https://api.scanova.io/qr/validate-info/"

payload = {
    "info": "{\"type\":\"url\",\"data\":{\"url\":\"https://example.com/summer-sale\"}}",
    "category": 3
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    info: '{"type":"url","data":{"url":"https://example.com/summer-sale"}}',
    category: 3
  })
};

fetch('https://api.scanova.io/qr/validate-info/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.scanova.io/qr/validate-info/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'info' => '{"type":"url","data":{"url":"https://example.com/summer-sale"}}',
    'category' => 3
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.scanova.io/qr/validate-info/"

	payload := strings.NewReader("{\n  \"info\": \"{\\\"type\\\":\\\"url\\\",\\\"data\\\":{\\\"url\\\":\\\"https://example.com/summer-sale\\\"}}\",\n  \"category\": 3\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.scanova.io/qr/validate-info/")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"info\": \"{\\\"type\\\":\\\"url\\\",\\\"data\\\":{\\\"url\\\":\\\"https://example.com/summer-sale\\\"}}\",\n  \"category\": 3\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.scanova.io/qr/validate-info/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"info\": \"{\\\"type\\\":\\\"url\\\",\\\"data\\\":{\\\"url\\\":\\\"https://example.com/summer-sale\\\"}}\",\n  \"category\": 3\n}"

response = http.request(request)
puts response.read_body

"valid"

POST

validate-info

Validate QR content against a category schema

curl --request POST \
  --url https://api.scanova.io/qr/validate-info/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "info": "{\"type\":\"url\",\"data\":{\"url\":\"https://example.com/summer-sale\"}}",
  "category": 3
}
'

import requests

url = "https://api.scanova.io/qr/validate-info/"

payload = {
    "info": "{\"type\":\"url\",\"data\":{\"url\":\"https://example.com/summer-sale\"}}",
    "category": 3
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    info: '{"type":"url","data":{"url":"https://example.com/summer-sale"}}',
    category: 3
  })
};

fetch('https://api.scanova.io/qr/validate-info/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.scanova.io/qr/validate-info/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'info' => '{"type":"url","data":{"url":"https://example.com/summer-sale"}}',
    'category' => 3
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.scanova.io/qr/validate-info/"

	payload := strings.NewReader("{\n  \"info\": \"{\\\"type\\\":\\\"url\\\",\\\"data\\\":{\\\"url\\\":\\\"https://example.com/summer-sale\\\"}}\",\n  \"category\": 3\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.scanova.io/qr/validate-info/")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"info\": \"{\\\"type\\\":\\\"url\\\",\\\"data\\\":{\\\"url\\\":\\\"https://example.com/summer-sale\\\"}}\",\n  \"category\": 3\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.scanova.io/qr/validate-info/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"info\": \"{\\\"type\\\":\\\"url\\\",\\\"data\\\":{\\\"url\\\":\\\"https://example.com/summer-sale\\\"}}\",\n  \"category\": 3\n}"

response = http.request(request)
puts response.read_body

"valid"

Purpose

Use this endpoint to validate QR Code data before creation.
It checks that the category and info parameters match expected JSON structure for that QR type (e.g., URL, Social Media, Business Card, etc.). This helps catch issues like:

Missing required fields
Invalid URLs
Wrong type values
Malformed JSON strings

Request Body (Form Data)

Field	Type	Required	Description	Example
`category`	string	Yes	QR code category ID	`1`
`info`	string	Yes	QR code info JSON data	`{"type":"url","data":{"url":"http://google.com"}}`

Examples

Validate Website URL QR Code Data

curl -X POST "https://management.scanova.io/qr/validate-info/" \
  -H "Authorization: YOUR_API_KEY" \
  -F "category=1" \
  -F "info={\"type\":\"url\",\"data\":{\"url\":\"https://example.com\"}}"

curl -X POST "https://management.scanova.io/qr/validate-info/" \
  -H "Authorization: YOUR_API_KEY" \
  -F "category=15" \
  -F "info={\"type\":\"sMedia\",\"data\":{\"facebook\":\"https://facebook.com/example\",\"instagram\":\"https://instagram.com/example\"}}"

Validate Business Card QR Code Data

curl -X POST "https://management.scanova.io/qr/validate-info/" \
  -H "Authorization: YOUR_API_KEY" \
  -F "category=24" \
  -F "info={\"type\":\"businessCard\",\"data\":{\"name\":\"John Doe\",\"email\":\"john@example.com\",\"phone\":\"+1234567890\"}}"

Validate Event QR Code Data

curl -X POST "https://management.scanova.io/qr/validate-info/" \
  -H "Authorization: YOUR_API_KEY" \
  -F "category=20" \
  -F "info={\"type\":\"event\",\"data\":{\"title\":\"Tech Conference 2025\",\"date\":\"2025-06-15\",\"location\":\"Convention Center\"}}"

Successful Response (200)

If the provided data is valid, the API returns a simple success message:

"valid"

HTTP Status: 200 OK

Error Responses

`400 Bad Request` — Invalid Data

The info object failed validation.
Common issues include missing fields, invalid type, or incorrect data formats. Example - Invalid Type Values

{
  "info": [
    "'invalid_type' is not one of ['url', 'email', 'phone', 'text']"
  ]
}

Example - Missing Required Fields

{
  "info": [
    "This field is required."
  ]
}

Example - Invalid URL Format

{
  "info": [
    "Enter a valid URL."
  ]
}

Example - Invalid Email Format

{
  "info": [
    "Enter a valid email address."
  ]
}

Example - Invalid Phone Format

{
  "info": [
    "Enter a valid phone number."
  ]
}

Integration Examples

JavaScript Form Validation

async function validateQRCodeData(category, infoData) {
  try {
    const formData = new FormData();
    formData.append('category', category);
    formData.append('info', JSON.stringify(infoData));
    
    const response = await fetch('https://management.scanova.io/qr/validate-info/', {
      method: 'POST',
      headers: {
        'Authorization': 'YOUR_API_KEY'
      },
      body: formData
    });
    
    if (response.ok) {
      const result = await response.text();
      if (result === '"valid"') {
        return { valid: true, message: 'Data is valid' };
      }
    } else {
      const error = await response.json();
      return { valid: false, message: error.info[0] };
    }
  } catch (error) {
    return { valid: false, message: 'Validation failed' };
  }
}

// Usage
const result = await validateQRCodeData(1, {
  type: 'url',
  data: { url: 'https://example.com' }
});

if (result.valid) {
  // Proceed with QR code creation
  console.log('Data is valid, creating QR code...');
} else {
  // Show error to user
  console.error('Validation error:', result.message);
}

Python Validation

import requests
import json

def validate_qr_code_data(category, info_data):
    url = "https://management.scanova.io/qr/validate-info/"
    headers = {"Authorization": "YOUR_API_KEY"}
    
    data = {
        'category': str(category),
        'info': json.dumps(info_data)
    }
    
    try:
        response = requests.post(url, headers=headers, data=data)
        
        if response.status_code == 200:
            result = response.text.strip('"')
            if result == 'valid':
                return {"valid": True, "message": "Data is valid"}
        elif response.status_code == 400:
            error_data = response.json()
            return {"valid": False, "message": error_data['info'][0]}
        
        return {"valid": False, "message": "Validation failed"}
        
    except Exception as e:
        return {"valid": False, "message": f"Error: {str(e)}"}

# Usage
result = validate_qr_code_data(1, {
    "type": "url",
    "data": {"url": "https://example.com"}
})

if result["valid"]:
    print("Data is valid, creating QR code...")
else:
    print(f"Validation error: {result['message']}")

PHP Validation

<?php
function validateQRCodeData($category, $infoData) {
    $url = "https://management.scanova.io/qr/validate-info/";
    $headers = [
        "Authorization: YOUR_API_KEY"
    ];
    
    $data = [
        'category' => (string)$category,
        'info' => json_encode($infoData)
    ];
    
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
    curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    
    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    
    if ($httpCode === 200) {
        $result = trim($response, '"');
        if ($result === 'valid') {
            return ["valid" => true, "message" => "Data is valid"];
        }
    } elseif ($httpCode === 400) {
        $errorData = json_decode($response, true);
        return ["valid" => false, "message" => $errorData['info'][0]];
    }
    
    return ["valid" => false, "message" => "Validation failed"];
}

// Usage
$result = validateQRCodeData(1, [
    "type" => "url",
    "data" => ["url" => "https://example.com"]
]);

if ($result["valid"]) {
    echo "Data is valid, creating QR code...";
} else {
    echo "Validation error: " . $result["message"];
}
?>

Notes & Best Practices

Always validate before creating or updating dynamic QR Codes — this ensures error-free QR landing pages.
The validation engine mimics internal creation logic, so a passing validation guarantees successful QR creation (if unchanged).
Recommended especially when:
- Building integrations that generate multiple QR codes in bulk
- Accepting user-provided input through a form or external data source
Use this endpoint in your pre-deployment QA pipeline to validate info templates for all categories.

Authorizations

Authorization

string

header

required

Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: YOUR_API_KEY. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.

Response

The payload is valid.

Getting Started

Reference

QR Code Management

Folder Management

Form Management

Lead List Management

User Management

Analytics & Reporting

Purpose

Request Body (Form Data)

Examples

Validate Website URL QR Code Data

Validate Business Card QR Code Data

Validate Event QR Code Data

Successful Response (200)

Error Responses

`400 Bad Request` — Invalid Data

Integration Examples

JavaScript Form Validation

Python Validation

PHP Validation

Notes & Best Practices

Authorizations

Response

​Purpose

​Request Body (Form Data)

​Examples

​Validate Website URL QR Code Data

​Validate Social Media QR Code Data

​Validate Business Card QR Code Data

​Validate Event QR Code Data

​Successful Response (200)

​Error Responses

​400 Bad Request — Invalid Data

​Integration Examples

​JavaScript Form Validation

​Python Validation

​PHP Validation

​Notes & Best Practices

Authorizations

Response

Purpose

Request Body (Form Data)

Examples

Validate Website URL QR Code Data

Validate Social Media QR Code Data

Validate Business Card QR Code Data

Validate Event QR Code Data

Successful Response (200)

Error Responses

`400 Bad Request` — Invalid Data

Integration Examples

JavaScript Form Validation

Python Validation

PHP Validation

Notes & Best Practices