Endpoint
GEThttps://qrwing.com/api/qr
Restituisce un'immagine direttamente. Tutti i parametri vengono passati come argomenti di query string. CORS è aperto — l'endpoint può essere chiamato da qualsiasi origine.
Avvio Rapido
# 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" />
Parametri
| Parametro | Tipo | Predefinito | Descrizione |
|---|---|---|---|
| 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. |
Tipi di QR Code
Passa type= con uno dei valori seguenti. Ogni tipo richiede i propri parametri di contenuto.
emailEmailemailEmail addresssubjectEmail subject (optional)bodyEmail body (optional)phoneTelefonophonePhone number with country codesmsSMSphonePhone numbermessagePre-filled message (optional)wifiWiFissidNetwork name (SSID)passwordWiFi passwordencryptionWPA | WEP | nopasshiddentrue if network is hiddenvcardvCardnameFull name (required)orgOrganizationphonePhone numberemailEmail addressurlWebsite URLaddressStreet addresslocationPosizionelatLatitudelngLongitudequerySearch query instead of coordinateswhatsappWhatsAppphonePhone number with country code (no +)messagePre-filled message (optional)telegramTelegramusernameTelegram username (without @)messagePre-filled message (optional)calendarEventotitleEvent title (required)startStart datetime ISO 8601endEnd datetime ISO 8601locationEvent locationdescriptionEvent descriptionallDaytrue for all-day eventsyoutubeYouTubeurlYouTube video, channel, or playlist URLtwitterTwitter / XusernameTwitter/X username (without @)facebookFacebookurlFacebook page or profile URLlinkedinLinkedInurlLinkedIn profile or page URLinstagramInstagramusernameInstagram username (without @)bitcoinBitcoinaddressBitcoin address (required)amountAmount in BTC (optional)labelPayment label (optional)messagePayment message (optional)zoomZoomurlFull Zoom meeting URL (preferred)meetingIdMeeting ID (if no URL)passwordMeeting password (optional)appstoreApp StoreiosUrlApple App Store URLandroidUrlGoogle Play Store URLpaypalPayPalusernamePayPal.me usernameamountRequest amount (optional)currencyCurrency code (optional)Esempi Live
Clicca su qualsiasi URL per aprirlo nel tuo browser e visualizzare il QR code generato.
Simple URL QR — PNG
https://qrwing.com/api/qr?type=url&url=https://qrwing.comURL — SVG, blue, large
https://qrwing.com/api/qr?type=url&url=https://qrwing.com&format=svg&fg=1d4ed8&size=500URL — dots style, colored
https://qrwing.com/api/qr?type=url&url=https://qrwing.com&style=dots&fg=7c3aed&bg=faf5ffRisposta
In caso di successo, l'API restituisce il binario dell'immagine con l'intestazione Content-Type appropriata:
| Formato | Content-Type |
|---|---|
| png | image/png |
| svg | image/svg+xml |
| webp | image/webp |
In caso di errore, l'API restituisce JSON con stato 400 o 500:
{"error": "Missing required parameter: type"}
Caching e Limiti di Velocità
Le risposte includono Cache-Control: public, max-age=86400 in modo che le immagini vengano memorizzate nella cache per 24 ore dai browser e dalle CDN.
L'API è gratuita e non richiede autenticazione. Ti chiediamo di evitare richieste automatizzate eccessive. Per la generazione in blocco (>1.000 QR code/giorno), ti preghiamo di contattarci.
Esempi di Integrazione
HTML
<img
src="https://qrwing.com/api/qr?type=url&url=https://qrwing.com&size=200"
alt="QR Code"
width="200"
height="200"
/>
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);