Validate QR Code Info Data - Scanova API Documentation

curl --request POST \
  --url https://management.scanova.io/qr/validate-info/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: multipart/form-data' \
  --form category=1 \
  --form 'info={"type":"url","data":{"url":"https://example.com"}}'

"valid"

POST

validate-info

curl --request POST \
  --url https://management.scanova.io/qr/validate-info/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: multipart/form-data' \
  --form category=1 \
  --form 'info={"type":"url","data":{"url":"https://example.com"}}'

"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

API key authentication. Enter your API key directly in the Authorization header.

Body

multipart/form-data

Response

Valid QR code info data

The response is of type string.

Example:

"valid"

Get QR Code Categories Create QR Code

​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