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 ou clé API requise.

L'image est retournée en tant que PNG avec tous les styles de code 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 retourne une image PNG 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'email, un PDF ou tout système qui prend en charge les URLs 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 hex doivent être encodées en URL — utilisez %23 à la place de # (par exemple %23ff0000 pour #ff0000).

Les dimensions du logo sont automatiquement mises à l'échelle pour correspondre à la taille d'image demandée.

La quietZone ajoute un espacement blanc autour de l'ensemble du code QR, 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 collés au bord et peuvent ne pas scanner de manière fiable. Par exemple, quietZone=50&bgColor=%23ffffff ajoute une bordure blanche de 50 pixels.

Définition des styles via l'API des liens

Vous pouvez enregistrer les styles de code QR à un lien lors de sa création ou sa mise à jour via l'API de raccourcissement des liens. Transmettez un objet JSON qr_styles avec n'importe lequel des clés de style listé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 nécessaire.

Comment les styles sont appliqués

Les styles de code 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 — Toute personnalisation que vous avez effectuée dans l'éditeur de code QR ou définie via l'API des liens est stockée avec le lien
3. 3
   Remplacements des paramètres de requête — Remplacez les styles individuels par requête via les paramètres d'URL

Quand un logo est présent, Linkly utilise automatiquement la correction d'erreur élevée (Niveau H) pour s'assurer que le code QR reste scannable.

Limites de débit

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

Réponse

Une requête réussie retourne un statut 200 avec Content-Type: image/png et les données de l'image PNG comme corps de réponse.

Les réponses d'erreur retournent JSON :

{"error": "Rate limit exceeded"}

Ressources associées

• 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 des codes QR au format vectoriel évolutif
• API de raccourcissement des liens - Créez et gérez les liens par programmation
• API Analytics - Exportez les données de clics et les rapports de trafic