API Générateur de codes QR

Générez des images de codes QR en ajoutant .qr.png à n'importe quel lien court Linkly. Aucune authentification ni clé API requise.

L'image est renvoyée en tant que PNG avec tous les styles de codes QR enregistrés appliqués, y compris les couleurs personnalisées, les motifs de points, les styles d'yeux et les logos.

Utilisation de base

Ajoutez .qr.png à n'importe quel lien court Linkly :

https://linkly.link/2W6Z9.qr.png

Cela renvoie une image PNG de 1024x1024 du code QR. Si vous avez personnalisé les couleurs, le style ou le logo du code QR dans Linkly, ces styles sont automatiquement appliqués.

Exemple

Intégrez un code QR dans une page HTML :

<img src="https://linkly.link/2W6Z9.qr.png" alt="QR Code" />

Ou utilisez-le dans un modèle d'e-mail, un PDF ou tout système prenant en charge les URL d'image.

Paramètres de style

Transmettez des paramètres de requête pour remplacer les styles QR enregistrés du lien ou modifier la taille de l'image :

https://linkly.link/2W6Z9.qr.png?qrStyle=dots&fgColor=%23009eff&size=2048

Remarque : les couleurs hexadécimales doivent être encodées en URL — utilisez %23 à la place de # (par exemple %23ff0000 pour #ff0000).

Les dimensions du logo sont automatiquement redimensionnées pour correspondre à la taille d'image demandée.

La quietZone ajoute un remplissage d'espace blanc autour du code QR entier, rempli avec bgColor. Ceci est utile lors de l'impression de codes QR sur des arrière-plans sombres — sans cela, les yeux de positionnement sont flush contre le bord et peuvent ne pas scanner fiablement. Par exemple, quietZone=50&bgColor=%23ffffff ajoute une bordure blanche de 50 pixels.

Définition des styles via l'API de lien

Vous pouvez enregistrer les styles de codes QR sur un lien lors de sa création ou de sa mise à jour via l'API de raccourcissement de lien. Transmettez un objet JSON qr_styles avec l'une des clés de style répertoriées ci-dessus :

{
  "api_key": "your_api_key",
  "workspace_id": 1234,
  "url": "https://example.com",
  "qr_styles": {
    "fgColor": "#009eff",
    "bgColor": "#ffffff",
    "qrStyle": "dots",
    "eyeStyle": "rounded",
    "logoImage": "https://example.com/logo.png",
    "logoWidth": 60,
    "logoHeight": 60,
    "logoPadding": 10,
    "logoStyle": "circle",
    "quietZone": 50
  }
}

Une fois enregistrés, ces styles sont automatiquement appliqués chaque fois que vous demandez l'image .qr.png — aucun paramètre de requête requis.

Application des styles

Les styles de codes QR sont résolus dans l'ordre suivant :

1. 1
   Styles par défaut — Premier plan noir sur fond transparent, modules carrés, 1024px
2. 2
   Styles enregistrés — Toutes les personnalisations que vous avez effectuées dans l'éditeur de codes QR ou définies via l'API de lien sont stockées avec le lien
3. 3
   Remplacements des paramètres de requête — Remplacez des styles individuels par demande via des paramètres d'URL

Lorsqu'un logo est présent, Linkly utilise automatiquement une correction d'erreur de haut niveau (Niveau H) pour assurer que le code QR reste scannabe.

Limites de débit

Le point de terminaison est limité à 5 demandes par seconde par adresse IP. Les images sont mises en cache pendant 5 minutes, donc les demandes répétées pour le même code QR sont traitées rapidement.

Réponse

Une demande réussie renvoie un statut 200 avec Content-Type: image/png et les données de l'image PNG en tant que corps de réponse.

Les réponses d'erreur renvoient du JSON :

{"error": "Rate limit exceeded"}

Ressources connexes

• Créer des codes QR - Comment créer et personnaliser des codes QR dans Linkly
• Ajouter un logo à un code QR - Créez des codes QR de marque avec votre logo d'entreprise
• Codes QR SVG - Téléchargez les codes QR au format vectoriel évolutif
• API de raccourcissement de lien - Créez et gérez les liens par programme
• API d'analyse - Exportez les données de clics et les rapports de trafic