Qivoاستوديو QR Code
إنشاء رمز 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 في تاريخ المتصفح أو سجلات الخادم.

نموذج الرمز

حفظ المفتاح في متغير البيئة 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())

الرموز upload

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 على الويكتور.يتم إدراج الشعار الذي تم تحميله كصورة مسطحة نظيفة بحيث لا تصبح تفاصيلها غير محدودة.للوحة كبيرة، فحص حادة الشعار بشكل منفصل.

معلمات التصميم

المعاييرالنوعمتطلباتالقيم
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

أنواع المحتوى

المجالات تعتمد على المحتوىنوع.للعنوان URL، إعطاء عنوان كامل 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. Content-Type هو image/png أو image/svg+xml. Errors are returned as 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 — لا يتم تكوين الوصول إلى API أو الحماية غير متوفرة مؤقتًا.
  • 500 — خطأ الجيل الداخلي

الحدود والتصديق

الحد الافتراضي هو 60 طلبًا في الدقيقة لكل IP. يقتصر المحتوى المشفر على 800 بايت. يدعم إنتاج PNG ما يصل إلى 2048 × 2048 بكسل.

تثبت API تنسيقات المعلمات والحجم والتباين، ولكنها لا تعمل على التخزين أو التحقق مما إذا كانت QR تتصفح.

الحصول على الوصول

API مجاني وسوف يبقى دائما مجانا.ملء النموذج القصير لطلب مفتاح سرية.

سيتم إرسال تفاصيل النموذج إلى فريق Qivo لمراجعة طلبك والرد.