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 tant que PNG avec tous les styles de code QR enregistrés appliqués, notamment les couleurs personnalisées, les motifs de points, les styles d'œil 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 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 prenant 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
| Paramètre | Description | Exemple |
|---|---|---|
| size | Taille de l'image en pixels (100–2048) | 1024 |
| fgColor | Couleur de premier plan (hex, codée en URL) | %23009eff |
| bgColor | Couleur de fond (hex, codée en URL) | %23ffffff |
| qrStyle | Style de module | squares, dots ou fluid |
| eyeStyle | Style du motif d'œil | square ou rounded |
| eyeColorInner | Couleur de l'œil interne (hex) | %23ff0000 |
| eyeColorOuter | Couleur de l'œil externe (hex) | %230000ff |
| logoImage | URL de l'image du logo | https://example.com/logo.png |
| logoWidth | Largeur du logo en pixels | 60 |
| logoHeight | Hauteur du logo en pixels | 60 |
| logoPadding | Remplissage autour du logo en pixels | 10 |
| logoStyle | Forme du remplissage du logo | square ou circle |
| quietZone | Remplissage autour du code QR en pixels (0–200) | 50 |
Remarque : les couleurs hex doivent être codé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 remplissage d'espace 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 flush contre le bord et peuvent 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 sur un lien lors de sa création ou de sa mise à jour via l'API Shortening Link. Passez un objet JSON qr_styles avec l'une 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 :
- 1Styles par défaut — Avant-plan noir sur arrière-plan transparent, modules carrés, 1024px
- 2Styles enregistrés — Toutes les personnalisations que vous avez apportées dans l'éditeur de code QR ou définies via l'API de lien sont stockées avec le lien
- 3Remplacements des paramètres de requête — Remplacez les styles individuels par requête via les paramètres d'URL
Lorsqu'un logo est présent, Linkly utilise automatiquement la 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 requêtes répétées pour le même code QR sont servies rapidement.
Réponse
Une requête réussie renvoie un statut 200 avec Content-Type: image/png et les données d'image PNG comme corps de la réponse.
Les réponses d'erreur renvoient JSON :
{"error": "Rate limit exceeded"}
FAQ API Générateur de Code QR
Ai-je besoin d'une clé API pour obtenir une image de code QR ?
Non. Ajoutez simplement .qr.png à votre URL de lien court. Ceci est public et ne nécessite aucune authentification.
Puis-je intégrer l'image du code QR dans des emails ou des pages web ?
Oui. L'URL .qr.png est conçue pour l'intégration. Utilisez-la comme source <img> dans les emails HTML, les pages web, les PDF ou tout système prenant en charge les URL d'image.
Les couleurs personnalisées et les logos sont-ils inclus ?
Oui. Les codes QR sont rendus avec tous les styles enregistrés, notamment les couleurs personnalisées, les motifs de points/fluides, les styles d'œil et les logos. Vous pouvez également remplacer n'importe quel style avec des paramètres de requête.
Quelle est la taille des images générées ?
La taille par défaut est 1024x1024 pixels. Vous pouvez spécifier une taille personnalisée de 100 à 2048 pixels en utilisant le paramètre de requête size, par exemple ABC123.qr.png?size=2048.
Y a-t-il une limite de débit ?
Oui. Le point de terminaison est limité à 5 requêtes par seconde par adresse IP. Si vous dépassez cela, vous recevrez un code de statut 429.
Puis-je définir les styles de code QR via l'API ?
Oui. Passez un objet qr_styles lors de la création ou de la mise à jour d'un lien via l'API Shortening Link. Les styles enregistrés sont automatiquement appliqués lorsque vous demandez l'image .qr.png. Consultez la section Définir les styles via l'API de lien ci-dessus.
Puis-je générer des codes QR au format SVG ?
Pas encore. L'API supporte actuellement le format PNG uniquement. La prise en charge SVG peut être ajoutée à l'avenir.
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 des codes QR au format vectoriel évolutif
- API Shortening Link - Créez et gérez des liens par programmation
- API Analytics - Exportez les données de clics et les rapports de trafic
Suivez 500 clics mensuels avec toutes les fonctionnalités incluses.
Aucune carte de crédit requise