API Générateur de Code QR

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

L'image est renvoyée en 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'e-mail, un PDF ou n'importe quel système qui prend en charge les URL d'image.

Paramètres de Style

Passez 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 URL-encodées — 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 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 collés au bord et pourraient ne pas scanner de manière fiable. Par exemple, quietZone=50&bgColor=%23ffffff ajoute une bordure blanche de 50 pixels.

Définir les Styles via l'API de Lien

Vous pouvez enregistrer les styles de code QR à un lien lors de sa création ou de sa mise à jour via l'API de Raccourcissement de Lien. Passez un objet JSON qr_styles avec n'importe quelle clé de style répertoriée 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 — Avant-plan noir sur arrière-plan 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 de Lien est stockée avec le lien
3. 3
   Remplacements des paramètres de requête — Remplacez les styles individuels par requête via des paramètres d'URL

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

Limites de Débit

Le point de terminaison est limité à 5 requêtes 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 servies rapidement.

Réponse

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

Les réponses d'erreur retournent JSON :

{"error": "Rate limit exceeded"}

Ressources Connexes

• Créer des Codes QR - Comment créer et personnaliser les codes QR dans Linkly
• Ajouter un Logo à un Code QR - Créer des codes QR de marque avec votre logo d'entreprise
• Codes QR SVG - Télécharger les codes QR au format vectoriel évolutif
• API de Raccourcissement de Lien - Créer et gérer les liens par programmation
• API Analytics - Exporter les données de clics et les rapports de trafic