QivoKode QR Studio
Membuat kode QR

Untuk integrasi

Kode QR dalam satu permintaan

Tambah generasi kode QR ke layanan Anda. mengirimkan pengaturan konten dan desain melalui GET / POST dan menerima PNG atau SVG tanpa pemeriksaan pemindaian tambahan.

bebas untuk selamanya.PNG, SVG dan API – tidak ada biaya atau langganan.

dengan kode QR langsung. Tidak ada redirect, tidak ada habisnya.

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

Permintaan dan autentikasi

Tuliskan kunci Anda di kepala X-API-Key. sesi editor dan cookie tidak diperlukan. QIVO_API_KEY dalam contoh ini adalah variabel lingkungan klien yang mengandung kunci Anda.

contoh curl
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

Jika integrasi Anda hanya menerima URL, masukkan kunci ke parameter kunci:

Contoh URL
https://qivo.umind.group/?key=YOUR_SECRET_KEY&data=https%3A%2F%2Fumind.group&format=png&size=1024

Mengganti YOUR_SECRET_KEY dengan kunci Anda. tajuk mengambil keunggulan di atas parameter kunci. nilai parameter kode URL: # → %23, + → %2B, dan & dalam nilai → %26.

Gunakan HTTPS dan simpan kunci pada server Anda.Jangan letakkan kunci di JavaScript publik.Kunci dan data dalam URL GET mungkin muncul dalam sejarah browser atau log server; prefer the headline for your key.

Contoh kode

Simpan kunci di variabel lingkungan QIVO_API_KEY; jangan menerbitkannya dalam kode halaman.

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())

Logotip upload

POSThttps://qivo.umind.group/

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

Qivo menerima file PNG, JPEG dan WebP hingga 2 MB, dengan sisi maksimum 2048 piksel. upload SVG tidak diterima. PNG atau WebP dengan transparansi bekerja baik untuk tanda tanpa latar belakang.

ParameterTipeKebutuhanNilai
X-API-KeyheaderDiperlukanYOUR_SECRET_KEY
logostringDiperlukanupload
logoFilefileDiperlukanPNG / JPEG / WebP · ≤ 2 MiB · ≤ 2048 × 2048 px · ≤ 4,000,000 px
logoScaleintegerPilihan12–30 · yang default: 24
logoPaddingintegerPilihan0–25% · yang default: 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)

Geometri QR di dalam SVG adalah berbasis vector. logo yang diunggah Anda tertanam sebagai gambar raster yang bersih, sehingga detailnya tidak menjadi tak terbatas. Untuk poster besar, periksa ketajaman logo secara terpisah.

Parameter desain

ParameterTipeKebutuhanNilai
X-API-Key / keystringDiperlukan
Kunci rahasia: header atau parameter GET
datastringUntuk teks dan url
Informasi yang dibutuhkan untuk text/url
contentTypestringPilihan
texturlwifivcardwhatsapptelegramphoneviberemailsms
yang default: text
formatstringPilihan
pngsvg
yang default: png
sizeintegerPilihan
25651210242048
yang default: 1024
shapestringPilihan
squaresoftroundeddotsleaf-softleafhorizontalverticalpointednotchedstardiamondxx-roundedplusplus-roundedheartsparkleconfetti
yang default: square
borderstringPilihan
squarecircleroundedskewdrop-tldrop-brleafleaf-inner-brleaf-circleleaf-inner-tlsquare-circlesoft-tlsoft-brsoft-leafrough
yang default: square
centerstringPilihan
squarecircleroundedskewroughdrop-tldrop-brleafgearstardiamondxx-roundedplusplus-roundedheart
yang default: square
foreground / eyeColorstringPilihan
#RRGGBB
yang default: #192b39
backgroundstringPilihan
#RRGGBB
yang default: #ffffff
levelstringPilihan
LMQH
yang default: M
quietZoneintegerPilihan
0 - 12 modul
yang default: 4
logostringPilihan
noneuploadwhatsapplinklocationwificredentialemailscanbellmenuscan-mescan-me-v2paypalbitcoinsparkplusdiamond
yang default: none
logoScaleintegerPilihan
12–30
yang default: 24
logoPaddingintegerPilihan
0–25%
yang default: 5

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

Jenis konten

Untuk URL, berikan alamat lengkap https:// atau http://. Untuk nomor telepon, termasuk kode negara.

contentTypeBidang yang diperlukanBidang optional
text / urldata—
phone / viberphone—
whatsapp / smsphonemessage
telegramtelegram—
emailemailsubject, message
wifissid; wifiSecurity≠nopass → wifiPasswordwifiSecurity (WPA), wifiHidden (0)
vcardfirstName / lastNameorganization, jobTitle, phone, email, website, address
Contoh telepon
https://qivo.umind.group/?key=YOUR_SECRET_KEY&contentType=phone&phone=%2B380671234567&format=svg

Tanggapan api

Jawaban yang sukses adalah file gambar itu sendiri, tanpa pengikat JSON.Tipe konten adalah image/png atau image/svg+xml.

JSON
{"error":"Invalid API key."}
  • 200 — Gambar yang dihasilkan.
  • 401 — kekurangan atau kekurangan kunci.
  • 405 — GET / POST
  • 413 — Content-Length > 3 MiB
  • 415 — POST: multipart/form-data
  • 422 — Parameter yang tidak sah atau konten yang hilang.
  • 429 — Rata-rata yang melebihi batas; Retry-After: 60.
  • 503 — Akses API tidak terkonfigurasi atau perlindungan sementara tidak tersedia.
  • 500 — Kesalahan Generasi Internal

Batas dan validasi

Batas default adalah 60 permintaan per menit per IP. Kandungan terkod terbatas pada 800 byte. output PNG mendukung hingga 2048 × 2048 px. SVG mempertahankan bentuk vektor.

API validasi format parameter, ukuran dan kontras, tetapi tidak menjalankan decoder atau memeriksa apakah QR scans.

Dapatkan Akses

API gratis dan akan selalu bebas. lengkapkan formulir singkat untuk meminta kunci rahasia.

Semua tiga bidang diperlukan. rincian formulir akan dikirim ke tim Qivo untuk meninjau permintaan dan jawaban Anda.