Справочник по API | QRWing

Эндпоинт

GEThttps://qrwing.com/api/qr

Возвращает изображение напрямую. Все параметры передаются как аргументы строки запроса. CORS открыт — эндпоинт можно вызывать из любого источника.

Быстрый старт

# URL QR as PNG (default) https://qrwing.com/api/qr?type=url&url=https://qrwing.com # Blue SVG with dots style https://qrwing.com/api/qr?type=url&url=https://qrwing.com&format=svg&fg=1d4ed8&style=dots # WiFi QR https://qrwing.com/api/qr?type=wifi&ssid=HomeNetwork&password=mypassword&encryption=WPA

# curl curl -o qr.png "https://qrwing.com/api/qr?type=url&url=https://qrwing.com" # HTML img tag <img src="https://qrwing.com/api/qr?type=url&url=https://qrwing.com" alt="QR Code" />

Параметры

Параметр	Тип	По умолчанию	Описание
type required	string	—	QR code type. See supported types below.
format optional	svg \| png \| webp	png	Output image format.
size optional	integer	300	Output size in pixels (50–2000).
margin optional	integer	4	Quiet zone in modules (0–20).
ec optional	L \| M \| Q \| H	M	Error correction level. Higher = more redundancy.
fg optional	hex	000000	Foreground (dot) color as 6-digit hex (no #).
bg optional	hex	ffffff	Background color as 6-digit hex (no #).
transparent optional	boolean	false	Transparent background (SVG/WebP/PNG).
style optional	square \| dots \| rounded	square	Dot style.

Типы QR-кодов

Передайте type= с одним из значений ниже. Каждый тип требует своих собственных параметров содержимого.

urlURL

urlFull URL including https://e.g. https://qrwing.com

https://qrwing.com/api/qr?type=url&url=https%3A%2F%2Fqrwing.com

textТекст

textPlain text contente.g. Hello, World!

https://qrwing.com/api/qr?type=text&text=Hello%2C%20World!

emailЭл. почта

emailEmail addresse.g. hello@example.com

subjectEmail subject (optional)e.g. Hello

bodyEmail body (optional)e.g. How are you?

https://qrwing.com/api/qr?type=email&email=hello%40example.com

phoneТелефон

phonePhone number with country codee.g. +14155552671

https://qrwing.com/api/qr?type=phone&phone=%2B14155552671

smsСМС

phonePhone numbere.g. +14155552671

messagePre-filled message (optional)e.g. Hey!

https://qrwing.com/api/qr?type=sms&phone=%2B14155552671

wifiWiFi

ssidNetwork name (SSID)e.g. MyNetwork

passwordWiFi passworde.g. secret123

encryptionWPA | WEP | nopasse.g. WPA

hiddentrue if network is hiddene.g. false

https://qrwing.com/api/qr?type=wifi&ssid=MyNetwork

vcardvCard

nameFull name (required)e.g. Jane Doe

orgOrganizatione.g. Acme Corp

phonePhone numbere.g. +14155552671

emailEmail addresse.g. jane@example.com

urlWebsite URLe.g. https://example.com

addressStreet addresse.g. 123 Main St

https://qrwing.com/api/qr?type=vcard&name=Jane%20Doe

locationМестоположение

latLatitudee.g. 37.7749

lngLongitudee.g. -122.4194

querySearch query instead of coordinatese.g. Golden Gate Bridge

https://qrwing.com/api/qr?type=location&lat=37.7749

whatsappWhatsApp

phonePhone number with country code (no +)e.g. 14155552671

messagePre-filled message (optional)e.g. Hi there!

https://qrwing.com/api/qr?type=whatsapp&phone=14155552671

telegramTelegram

usernameTelegram username (without @)e.g. qrwing

messagePre-filled message (optional)e.g. Hello!

https://qrwing.com/api/qr?type=telegram&username=qrwing

calendarСобытие

titleEvent title (required)e.g. Team Meeting

startStart datetime ISO 8601e.g. 2025-06-01T10:00:00

endEnd datetime ISO 8601e.g. 2025-06-01T11:00:00

locationEvent locatione.g. Zoom

descriptionEvent descriptione.g. Weekly sync

allDaytrue for all-day eventse.g. false

https://qrwing.com/api/qr?type=calendar&title=Team%20Meeting

youtubeYouTube

urlYouTube video, channel, or playlist URLe.g. https://youtube.com/watch?v=dQw4w9WgXcQ

https://qrwing.com/api/qr?type=youtube&url=https%3A%2F%2Fyoutube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ

twitterTwitter / X

usernameTwitter/X username (without @)e.g. qrwing

https://qrwing.com/api/qr?type=twitter&username=qrwing

facebookFacebook

urlFacebook page or profile URLe.g. https://facebook.com/qrwing

https://qrwing.com/api/qr?type=facebook&url=https%3A%2F%2Ffacebook.com%2Fqrwing

linkedinLinkedIn

urlLinkedIn profile or page URLe.g. https://linkedin.com/company/qrwing

https://qrwing.com/api/qr?type=linkedin&url=https%3A%2F%2Flinkedin.com%2Fcompany%2Fqrwing

instagramInstagram

usernameInstagram username (without @)e.g. qrwing

https://qrwing.com/api/qr?type=instagram&username=qrwing

bitcoinBitcoin

addressBitcoin address (required)e.g. 1A1zP1eP5QGefi2DMPTfTL5SLmv7Divf6

amountAmount in BTC (optional)e.g. 0.001

labelPayment label (optional)e.g. Donation

messagePayment message (optional)e.g. Thanks!

https://qrwing.com/api/qr?type=bitcoin&address=1A1zP1eP5QGefi2DMPTfTL5SLmv7Divf6

zoomZoom

urlFull Zoom meeting URL (preferred)e.g. https://zoom.us/j/123456789

meetingIdMeeting ID (if no URL)e.g. 123456789

passwordMeeting password (optional)e.g. abc123

https://qrwing.com/api/qr?type=zoom&url=https%3A%2F%2Fzoom.us%2Fj%2F123456789

appstoreApp Store

iosUrlApple App Store URLe.g. https://apps.apple.com/app/id123456

androidUrlGoogle Play Store URLe.g. https://play.google.com/store/apps/details?id=com.example

https://qrwing.com/api/qr?type=appstore&iosUrl=https%3A%2F%2Fapps.apple.com%2Fapp%2Fid123456

paypalPayPal

usernamePayPal.me usernamee.g. qrwing

amountRequest amount (optional)e.g. 9.99

currencyCurrency code (optional)e.g. USD

https://qrwing.com/api/qr?type=paypal&username=qrwing

Живые примеры

Нажмите на любой URL, чтобы открыть его в браузере и увидеть сгенерированный QR-код.

Simple URL QR — PNG

https://qrwing.com/api/qr?type=url&url=https://qrwing.com

URL — SVG, blue, large

https://qrwing.com/api/qr?type=url&url=https://qrwing.com&format=svg&fg=1d4ed8&size=500

URL — dots style, colored

https://qrwing.com/api/qr?type=url&url=https://qrwing.com&style=dots&fg=7c3aed&bg=faf5ff

WiFi QR

https://qrwing.com/api/qr?type=wifi&ssid=MyNetwork&password=secret123&encryption=WPA

WhatsApp QR

https://qrwing.com/api/qr?type=whatsapp&phone=14155552671&message=Hello!

vCard QR

https://qrwing.com/api/qr?type=vcard&name=Jane+Doe&org=Acme&phone=%2B14155552671&email=jane@example.com

Bitcoin payment

https://qrwing.com/api/qr?type=bitcoin&address=1A1zP1eP5QGefi2DMPTfTL5SLmv7Divf6&amount=0.001

Calendar event

https://qrwing.com/api/qr?type=calendar&title=Team+Meeting&start=2025-06-01T10:00:00&end=2025-06-01T11:00:00

Ответ

При успехе API возвращает двоичные данные изображения с соответствующим заголовком Content-Type:

Формат	Content-Type
png	image/png
svg	image/svg+xml
webp	image/webp

При ошибке API возвращает JSON со статусом 400 или 500:

{"error": "Missing required parameter: type"}

Кеширование и лимиты

Ответы включают Cache-Control: public, max-age=86400, поэтому изображения кешируются на 24 часа браузерами и CDN.

API бесплатен и не требует аутентификации. Мы просим вас избегать чрезмерных автоматических запросов. Для массовой генерации (>1000 QR-кодов в день), пожалуйста, свяжитесь с нами.

Примеры интеграции

HTML

JavaScript (fetch)

const url = new URL("https://qrwing.com/api/qr"); url.searchParams.set("type", "url"); url.searchParams.set("url", "https://qrwing.com"); url.searchParams.set("format", "svg"); url.searchParams.set("fg", "1d4ed8"); const response = await fetch(url); const svgText = await response.text(); document.getElementById("qr").innerHTML = svgText;

Python

import requests response = requests.get( "https://qrwing.com/api/qr", params={ "type": "url", "url": "https://qrwing.com", "format": "png", "size": 400, "style": "dots", "fg": "7c3aed", } ) with open("qr.png", "wb") as f: f.write(response.content)

PHP

$params = http_build_query([ 'type' => 'url', 'url' => 'https://qrwing.com', 'format' => 'png', 'size' => 300, ]); $img = file_get_contents("https://qrwing.com/api/qr?" . $params); file_put_contents('qr.png', $img);