QivoQR कोड स्टूडियो
QR कोड बनाएं

Integration के लिए

एक ही अनुरोध में QR कोड

अपनी सेवा में QR कोड जनरेशन जोड़ें. GET / POST के माध्यम से सामग्री और डिजाइन सेटिंग्स भेजें और बिना किसी अतिरिक्त स्कैन चेक के एक PNG या SVG प्राप्त करें.

हमेशा के लिए, हमेशा के लिएPNG, SVG और API – कोई शुल्क या सदस्यता नहीं।

सीधे QR कोड कोई रिलीज नहीं, कोई रिलीज नहीं।

GET / POSThttps://qivo.umind.group/

अनुरोध और सत्यापन

X-API-Key शीर्षक में अपना कुंजी दर्ज करें. संपादक सत्र और कुकीज़ की आवश्यकता नहीं है. QIVO_API_KEY इस उदाहरण में आपके कुंजी को शामिल करने वाले एक क्लाइंट पर्यावरण परिवर्तनीय है.

केरल उदाहरण
curl --fail --show-error --get 'https://qivo.umind.group/' \
  --header "X-API-Key: $QIVO_API_KEY" \
  --data-urlencode 'data=https://umind.group' \
  --data-urlencode 'contentType=url' \
  --data-urlencode 'format=svg' \
  --data-urlencode 'shape=rounded' \
  --data-urlencode 'size=1024' \
  --output qr-code.svg

यदि आपका एकीकरण केवल एक URL को स्वीकार करता है, तो कुंजी पैरामीटर में कुंजी पार करें:

उदाहरण के लिए URL
https://qivo.umind.group/?key=YOUR_SECRET_KEY&data=https%3A%2F%2Fumind.group&format=png&size=1024

अपने कुंजी के साथ YOUR_SECRET_KEY को प्रतिस्थापित करें. शीर्षक कुंजी पैरामीटर से अधिक प्राथमिकता लेता है. URL-कोडिंग पैरामीटर मूल्य: # → %23, + → %2B, और & एक मूल्य के भीतर → %26.

HTTPS का उपयोग करें और कुंजी को अपने सर्वर पर रखें. इसे सार्वजनिक जावास्क्रिप्ट में न रखें. GET URLs में कुंजी और डेटा ब्राउज़र इतिहास या सर्वर लॉग में दिखाई दे सकता है; अपने कुंजी के लिए शीर्षक को पसंद करें.

कोड उदाहरण

अपने सर्वर पर इन उदाहरणों को चलाएं. कुंजी को QIVO_API_KEY पर्यावरण चर में संग्रहीत करें; इसे पृष्ठ कोड में प्रकाशित न करें.

qr-code.php
<?php
$key = getenv('QIVO_API_KEY');
if (!$key) throw new RuntimeException('Set QIVO_API_KEY');
$query = http_build_query([
    'data' => 'https://umind.group', 'format' => 'svg',
    'shape' => 'rounded', 'size' => 1024,
], '', '&', PHP_QUERY_RFC3986);
$curl = curl_init('https://qivo.umind.group/?' . $query);
curl_setopt_array($curl, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-API-Key: ' . $key],
    CURLOPT_TIMEOUT => 30,
]);
$image = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_RESPONSE_CODE);
curl_close($curl);
if ($image === false || $status !== 200) {
    throw new RuntimeException('Qivo request failed: ' . $status);
}
file_put_contents('qr-code.svg', $image);
qr-code.mjs
import { writeFile } from 'node:fs/promises';
const key = process.env.QIVO_API_KEY;
if (!key) throw new Error('Set QIVO_API_KEY');
const url = new URL('https://qivo.umind.group/');
url.search = new URLSearchParams({
  data: 'https://umind.group', format: 'svg',
  shape: 'rounded', size: '1024'
});
const response = await fetch(url, {
  headers: { 'X-API-Key': key },
  signal: AbortSignal.timeout(30000)
});
if (!response.ok) throw new Error(`Qivo request failed: ${response.status}`);
await writeFile('qr-code.svg', Buffer.from(await response.arrayBuffer()));
qr-code.py
import os
from pathlib import Path
from urllib.parse import urlencode
from urllib.request import Request, urlopen

key = os.environ['QIVO_API_KEY']
query = urlencode({
    'data': 'https://umind.group', 'format': 'svg',
    'shape': 'rounded', 'size': 1024,
})
request = Request('https://qivo.umind.group/?' + query,
                  headers={'X-API-Key': key})
# urlopen raises HTTPError for unsuccessful HTTP responses.
with urlopen(request, timeout=30) as response:
    Path('qr-code.svg').write_bytes(response.read())

लॉग अपलोड

POSThttps://qivo.umind.group/

Content-Type: multipart/form-data
X-API-Key: YOUR_SECRET_KEY

Qivo PNG, JPEG और WebP फ़ाइलों को 2 एमबी तक स्वीकार करता है, एक अधिकतम पक्ष 2048 पिक्सेल के साथ. SVG अपलोड स्वीकार नहीं किए जाते हैं. पारदर्शिता के साथ PNG या WebP बिना किसी पृष्ठभूमि के एक निशान के लिए अच्छी तरह से काम करता है.

पैरामीटरप्रकारआवश्यकताएँमूल्य
X-API-KeyheaderजरूरीYOUR_SECRET_KEY
logostringजरूरीupload
logoFilefileजरूरीPNG / JPEG / WebP · ≤ 2 MiB · ≤ 2048 × 2048 px · ≤ 4,000,000 px
logoScaleintegerवैकल्पिक12–30 · वैकल्पिक: 24
logoPaddingintegerवैकल्पिक0–25% · वैकल्पिक: 5

GET → logo=none / whatsapp / …
POST → logo=upload + logoFile
logoUrl / logoBase64 / SVG / GIF → 422
Content-Length > 3 MiB → 413
level → H

cURL · multipart/form-data
curl --fail --show-error 'https://qivo.umind.group/' \
  --header "X-API-Key: $QIVO_API_KEY" \
  --form-string 'data=https://umind.group' \
  --form-string 'format=svg' \
  --form-string 'logo=upload' \
  --form-string 'logoPadding=10' \
  --form-string 'logoScale=24' \
  --form 'logoFile=@./logo.png;type=image/png' \
  --output qr-code.svg
PHP · CURLFile
<?php
$key = getenv('QIVO_API_KEY');
if (!$key) throw new RuntimeException('Set QIVO_API_KEY');
$curl = curl_init('https://qivo.umind.group/');
curl_setopt_array($curl, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-API-Key: ' . $key],
    CURLOPT_TIMEOUT => 30,
    CURLOPT_POSTFIELDS => [
        'data' => 'https://umind.group', 'format' => 'png',
        'logo' => 'upload', 'logoScale' => '24', 'logoPadding' => '10',
        'logoFile' => new CURLFile(__DIR__ . '/logo.png', 'image/png', 'logo.png'),
    ],
]);
$image = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_RESPONSE_CODE);
curl_close($curl);
if ($image === false || $status !== 200) throw new RuntimeException('Qivo: ' . $status);
file_put_contents('qr-code.png', $image);
JavaScript · Node.js 20+
import { readFile, writeFile } from 'node:fs/promises';
const key = process.env.QIVO_API_KEY;
if (!key) throw new Error('Set QIVO_API_KEY');
const form = new FormData();
form.set('data', 'https://umind.group');
form.set('format', 'svg');
form.set('logo', 'upload');
form.set('logoPadding', '10');
form.set('logoFile', new Blob([await readFile('./logo.png')], { type: 'image/png' }), 'logo.png');
// FormData supplies Content-Type and the multipart boundary automatically.
const response = await fetch('https://qivo.umind.group/', {
  method: 'POST', headers: { 'X-API-Key': key }, body: form,
  signal: AbortSignal.timeout(30000)
});
if (!response.ok) throw new Error(`Qivo: ${response.status}`);
await writeFile('qr-code.svg', Buffer.from(await response.arrayBuffer()));
Python · requests
# python -m pip install requests
import os
from pathlib import Path
import requests

with open('logo.png', 'rb') as logo:
    response = requests.post(
        'https://qivo.umind.group/',
        headers={'X-API-Key': os.environ['QIVO_API_KEY']},
        data={'data': 'https://umind.group', 'format': 'svg', 'logo': 'upload', 'logoPadding': '10'},
        files={'logoFile': ('logo.png', logo, 'image/png')},
        timeout=30,
    )
response.raise_for_status()
Path('qr-code.svg').write_bytes(response.content)

एक SVG के अंदर QR भूमेट्री वेक्टर-आधारित है. आपका अपलोड लॉग एक साफ रस्टर छवि के रूप में अंतर्निहित है, इसलिए इसकी विवरण असीमित नहीं हो जाती. एक बड़े पोस्टर के लिए, लॉग की चमक को अलग से जांचें.

डिजाइन पैरामीटर

पैरामीटरप्रकारआवश्यकताएँमूल्य
X-API-Key / keystringजरूरी
रहस्य कुंजी: शीर्षक या GET पैरामीटर
datastringपाठ और URL के लिए
पाठ / URL के लिए आवश्यक सामग्री
contentTypestringवैकल्पिक
texturlwifivcardwhatsapptelegramphoneviberemailsms
वैकल्पिक: text
formatstringवैकल्पिक
pngsvg
वैकल्पिक: png
sizeintegerवैकल्पिक
25651210242048
वैकल्पिक: 1024
shapestringवैकल्पिक
squaresoftroundeddotsleaf-softleafhorizontalverticalpointednotchedstardiamondxx-roundedplusplus-roundedheartsparkleconfetti
वैकल्पिक: square
borderstringवैकल्पिक
squarecircleroundedskewdrop-tldrop-brleafleaf-inner-brleaf-circleleaf-inner-tlsquare-circlesoft-tlsoft-brsoft-leafrough
वैकल्पिक: square
centerstringवैकल्पिक
squarecircleroundedskewroughdrop-tldrop-brleafgearstardiamondxx-roundedplusplus-roundedheart
वैकल्पिक: square
foreground / eyeColorstringवैकल्पिक
#RRGGBB
वैकल्पिक: #192b39
backgroundstringवैकल्पिक
#RRGGBB
वैकल्पिक: #ffffff
levelstringवैकल्पिक
LMQH
वैकल्पिक: M
quietZoneintegerवैकल्पिक
0-12 मॉड्यूल
वैकल्पिक: 4
logostringवैकल्पिक
noneuploadwhatsapplinklocationwificredentialemailscanbellmenuscan-mescan-me-v2paypalbitcoinsparkplusdiamond
वैकल्पिक: none
logoScaleintegerवैकल्पिक
12–30
वैकल्पिक: 24
logoPaddingintegerवैकल्पिक
0–25%
वैकल्पिक: 5

logo=upload → POST / · logoFile · level=H

सामग्री प्रकार

फ़ील्ड सामग्री के प्रकार पर निर्भर करते हैं. URLs के लिए, एक पूर्ण https:// या http:// पता प्रदान करें. फोन नंबरों के लिए, देश कोड शामिल है.

contentTypeआवश्यक क्षेत्रवैकल्पिक क्षेत्र
text / urldata—
phone / viberphone—
whatsapp / smsphonemessage
telegramtelegram—
emailemailsubject, message
wifissid; wifiSecurity≠nopass → wifiPasswordwifiSecurity (WPA), wifiHidden (0)
vcardfirstName / lastNameorganization, jobTitle, phone, email, website, address
फोन का उदाहरण
https://qivo.umind.group/?key=YOUR_SECRET_KEY&contentType=phone&phone=%2B380671234567&format=svg

आग का जवाब

एक सफल प्रतिक्रिया छवि फ़ाइल स्वयं है, कोई JSON ड्राइपर के बिना. सामग्री प्रकार छवि/png या छवि/svg+xml है. त्रुटियों को JSON के रूप में वापस किया जाता है:

JSON
{"error":"Invalid API key."}
  • 200 — चित्र बनाया गया है।
  • 401 — खोया हुआ या अक्षम कुंजी
  • 405 — GET / POST
  • 413 — Content-Length > 3 MiB
  • 415 — POST: multipart/form-data
  • 422 — अयोग्य पैरामीटर या अनुपस्थित सामग्री।
  • 429 — दर सीमा से अधिक; वापसी-अगला: 60।
  • 503 — एपीआई एक्सेस स्थापित नहीं किया गया है या सुरक्षा अस्थायी रूप से उपलब्ध नहीं है।
  • 500 — आंतरिक जनरल त्रुटि

सीमाएं और वैधता

डिफ़ॉल्ट सीमा IP प्रति मिनट 60 अनुरोध है. एन्कोडिंग सामग्री 800 बाइट्स तक सीमित है. PNG आउटपुट 2048 × 2048 पीएचएस तक का समर्थन करता है. SVG vector shapes को बनाए रखता है.

एपीआई पैरामीटर प्रारूपों, आकार और विपरीत को सत्यापित करता है, लेकिन एक डिकोडर चलाता नहीं है या जांच नहीं करता है कि क्या QR स्कैन करते हैं. एक कैमरे के साथ सजावटी संयोजन और मुद्रित आउटपुट का परीक्षण करें.

पहुंच प्राप्त करें

एपीआई मुफ्त है और हमेशा मुफ्त रहेगा. एक गुप्त कुंजी के लिए पूछने के लिए संक्षिप्त फॉर्म भरें.

सभी तीन फ़ील्ड आवश्यक हैं. फॉर्म विवरण आपके अनुरोध और जवाब की समीक्षा करने के लिए Qivo टीम को भेजा जाएगा.