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

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

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

Aucune carte de crédit requise