QivoQR কোড স্টুডিও
QR কোড তৈরি করুন

Integrations জন্য

একটি 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 ব্যবহার করুন এবং আপনার সার্ভারে চিঠি রাখুন. এটি জনপ্রিয় JavaScript মধ্যে রাখবেন না. 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 MB পর্যন্ত গ্রহণ করে, 2048 পিক্সেলের সর্বোচ্চ পাশের সাথে।

প্যারামিটারধরনপ্রয়োজনীয়তামূল্য
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

বিষয়বস্তু টাইপ

পৃথিবীগুলি বিষয়বস্তু থেকে নির্ভর করেType. 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 — তাপমাত্রা সীমা অতিক্রম; Retry-After: 60।
  • 503 — API অ্যাক্সেস সংগঠিত হয় না বা সুরক্ষা সাময়িকভাবে উপলব্ধ নয়।
  • 500 — অভ্যন্তরীণ প্রজন্মের ভুল

সীমাবদ্ধতা ও validation

আইপি-এ প্রতি মিনিট 60 অনুরোধ সীমাবদ্ধ। সংকোড করা বিষয়বস্তু 800 বিটের জন্য সীমাবদ্ধ। PNG উত্পাদন 2048 × 2048 px পর্যন্ত সমর্থন করে।

API প্যারামিটার ফরমেট, আকার এবং প্রতিরোধ সত্যি করে, কিন্তু একটি ডকোডার চালান না বা QR স্ক্যান করা হয় কিনা চেক করে।

অ্যাক্সেস করুন

APIটি বিনামূল্যে এবং সবসময় বিনামূল্যে থাকবে. একটি গোপন চিঠি অনুরোধ করার জন্য ছোট ফর্ম পূরণ করুন.

সব তিনটি পৃথিবী প্রয়োজন. ফর্ম বিস্তারিত আপনার অনুরোধ এবং উত্তর পরীক্ষা করার জন্য Qivo টিমকে পাঠানো হবে।