Point de Terminaison
GEThttps://qrwing.com/api/qr
Retourne une image directement. Tous les paramètres sont passés comme arguments de chaîne de requête. CORS est ouvert — le point de terminaison peut être appelé depuis n'importe quelle origine.
Démarrage Rapide
# 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" />
Paramètres
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
| 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. |
Types de QR Codes
Passez type= avec l'une des valeurs ci-dessous. Chaque type nécessite ses propres paramètres de contenu.
emailE-mailemailEmail addresssubjectEmail subject (optional)bodyEmail body (optional)phoneTéléphonephonePhone 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 addresslocationLocalisationlatLatitudelngLongitudequerySearch query instead of coordinateswhatsappWhatsAppphonePhone number with country code (no +)messagePre-filled message (optional)telegramTelegramusernameTelegram username (without @)messagePre-filled message (optional)calendarÉvénementtitleEvent 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)Exemples en Direct
Cliquez sur n'importe quelle URL pour l'ouvrir dans votre navigateur et voir le QR code généré.
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=faf5ffRéponse
En cas de succès, l'API retourne le binaire de l'image avec l'en-tête Content-Type approprié :
| Format | Content-Type |
|---|---|
| png | image/png |
| svg | image/svg+xml |
| webp | image/webp |
En cas d'erreur, l'API retourne du JSON avec un statut 400 ou 500 :
{"error": "Missing required parameter: type"}
Mise en Cache & Limites de Débit
Les réponses incluent Cache-Control: public, max-age=86400 afin que les images soient mises en cache pendant 24 heures par les navigateurs et les CDN.
L'API est gratuite et ne nécessite pas d'authentification. Nous vous demandons d'éviter les requêtes automatisées excessives. Pour la génération en masse (>1 000 QR codes/jour), veuillez nous contacter.
Exemples d'Intégration
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);