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.

Add .qr.png to any Linkly link to get the QR code, served as a PNG
Add .qr.png to any Linkly link to get the QR code, served as a PNG

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ètreDescriptionExemple
sizeTaille de l'image en pixels (100–2048)1024
fgColorCouleur de premier plan (hex, codée en URL)%23009eff
bgColorCouleur de fond (hex, codée en URL)%23ffffff
qrStyleStyle de modulesquares, dots ou fluid
eyeStyleStyle du motif d'œilsquare ou rounded
eyeColorInnerCouleur de l'œil interne (hex)%23ff0000
eyeColorOuterCouleur de l'œil externe (hex)%230000ff
logoImageURL de l'image du logohttps://example.com/logo.png
logoWidthLargeur du logo en pixels60
logoHeightHauteur du logo en pixels60
logoPaddingRemplissage autour du logo en pixels10
logoStyleForme du remplissage du logosquare ou circle
quietZoneRemplissage 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 :

  1. 1Styles par défaut — Avant-plan noir sur arrière-plan transparent, modules carrés, 1024px
  2. 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
  3. 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

Suivez 500 clics mensuels avec toutes les fonctionnalités incluses.

Aucune carte de crédit requise