API du 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 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://your-domain.com/ABC123.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://your-domain.com/ABC123.qr.png" alt="Code QR" />
Ou utilisez-le dans un modèle d'e-mail, un PDF ou tout système prenant en charge les URL d'images.
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://your-domain.com/ABC123.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, encodé URL) | %23009eff |
| bgColor | Couleur d'arrière-plan (hex, encodé URL) | %23ffffff |
| qrStyle | Style de module | squares, dots ou fluid |
| eyeStyle | Style du motif d'œil | square ou rounded |
| eyeColorInner | Couleur intérieure de l'œil (hex) | %23ff0000 |
| eyeColorOuter | Couleur extérieure de l'œil (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 | Espacement autour du logo en pixels | 10 |
| logoStyle | Forme de l'espacement du logo | square ou circle |
Note : les couleurs hex doivent être encodées en URL — utilisez %23 à la place de # (ex. %23ff0000 pour #ff0000).
Les dimensions du logo sont automatiquement mises à l'échelle pour correspondre à la taille d'image demandée.
Définir les Styles via l'API de Liens
Vous pouvez enregistrer les styles de code QR sur un lien lors de sa création ou mise à jour via l'API de Raccourcissement de Liens. Passez un objet JSON qr_styles avec n'importe laquelle 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"
}
}
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 — Premier plan noir sur fond transparent, modules carrés, 1024px
- 2Styles enregistrés — Toutes les personnalisations que vous avez faites dans l'éditeur de codes QR ou définies via l'API de Liens sont stockées avec le lien
- 3Remplacements par paramètres de requête — Remplacez des styles individuels par requête via les paramètres URL
Lorsqu'un logo est présent, Linkly utilise automatiquement une correction d'erreur élevée (Niveau H) pour garantir 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 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 de l'image PNG comme corps de la réponse.
Les réponses d'erreur renvoient du JSON :
{"error": "Rate limit exceeded"}
FAQ de l'API du Générateur de Codes QR
Ai-je besoin d'une clé API pour obtenir une image de code QR ?
Non. Ajoutez simplement .qr.png à l'URL de votre lien court. C'est public et ne nécessite aucune authentification.
Puis-je intégrer l'image du code QR dans des e-mails ou des pages web ?
Oui. L'URL .qr.png est conçue pour l'intégration. Utilisez-la comme source <img> dans les e-mails HTML, pages web, PDFs ou tout système prenant en charge les URL d'images.
Les couleurs personnalisées et les logos sont-ils inclus ?
Oui. Les codes QR sont rendus avec tous les styles enregistrés, y compris les couleurs personnalisées, les motifs points/fluides, les styles d'yeux 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 de 1024x1024 pixels. Vous pouvez spécifier une taille personnalisée de 100 à 2048 pixels en utilisant le paramètre de requête size, ex. 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 cette limite, 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 mise à jour d'un lien via l'API de Raccourcissement de Liens. Les styles enregistrés sont automatiquement appliqués lorsque vous demandez l'image .qr.png. Voir la section Définir les Styles via l'API de Liens ci-dessus.
Puis-je générer des codes QR au format SVG ?
Pas encore. L'API ne prend actuellement en charge que le format PNG. Le support SVG pourrait être ajouté à 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 le logo de votre entreprise
- Codes QR SVG - Téléchargez des codes QR au format vectoriel évolutif
- API de Raccourcissement de Liens - Créez et gérez des liens par programmation
- API d'Analyse - 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