API de génération de QR

Générez des QR codes personnalisables en un seul appel API.

Intégrez une URL, du texte ou un numéro de téléphone,
et ajustez couleurs, marqueurs, styles et logo selon votre image de marque.

Chaque QR code est fourni avec un lien—prêt à l’emploi ou téléchargeable en image.

  • Accédez au QR code via https://vvd.bz/[linkId]/qr et ajustez la taille avec le paramètre size.
  • Exemple : https://vvd.bz/hj7V/qr?size=500 → retourne un QR code de 500px (max. 4096px)
POST

/api/link/v1/create/qr 

{
    "type": "url",
    "url": "https://www.youtube.com/vivoldi365",
    "domain": "https://vvd.bz",
    "logoType": "U",
    "logo": "https://example.com/images/picture/logo/500x500.png"
}

Request Parameters

domain string required
Default:https://vvd.bz
Domaine du lien. Par défaut : https://vvd.bz. Si brandLinkId est défini, le domaine bascule vers https://vvd.im.
Vous pouvez également spécifier un domaine personnalisé.
type string required
Default:url
Enum:
urltextphone
Type de contenu du QR code.
  • url : URL de page web
  • text : Texte
  • phone : Numéro de téléphone
Les champs requis varient selon le type. Fournissez les paramètres correspondants.
url string
URL de destination lors du scan. Obligatoire si type = url. Doit être une URL complète en http ou https.
Longueur maximale : 2 000 bytes.
text string
Texte intégré dans le QR code. Utilisé si type = text. Affiché tel quel lors du scan.
Idéal pour messages, codes ou instructions. Le rendu peut varier selon l’appareil.
Longueur maximale : 65 535 bytes.
phone string
Numéro de téléphone déclenché au scan. Utilisé si type = phone. Ouvre l’écran d’appel.
Maximum : 32 caractères. Format international recommandé.
logoType string
Default:N
Enum:
NCU
Type de logo au centre du QR code.
  • N : Aucun logo
  • C : Logo par défaut de l’organisation
  • U : Logo personnalisé

Ajouter un logo renforce la reconnaissance de marque. Disponible à partir du plan Personal.

logo string
URL de l’image du logo au centre du QR code. Utilisé si logoType = U. Doit être accessible publiquement.
Format carré recommandé, PNG transparent conseillé.
Taille maximale : 500x500 px.
foreground string
Couleur principale du QR code (HEX). Noir par défaut.
Assurez un contraste suffisant avec le fond.
Default : #000000FF
background string
Couleur de fond (HEX). Blanc par défaut.
Un fond trop sombre peut réduire la lisibilité.
Default : #FFFFFFFF
markerColor string
Couleur des marqueurs de position.
Default : #000000FF
markerBorderColor string
Couleur des bordures des marqueurs.
Default : #000000FF
style string
Style visuel du QR code. Voir aperçu dans le dashboard.
markerStyle string
Style des marqueurs. Plusieurs formes disponibles.
grpIdx integer
Identifiant de groupe pour organiser les QR codes.
brandLinkId string
Si non défini, généré automatiquement. Domaine par défaut : https://vvd.im
ttl string
Titre interne.
memo string
Note interne (non visible pour les utilisateurs).
qrBypassYn string
Y : accès direct (sans tracking)
N : via lien court (tracking activé)
pushNotifyYn string
Notification push lors du scan.
mailNotifyYn string
Notification email lors du scan.
delYmdt datetime
Date de suppression automatique. 
{
    "code": 0,
    "message": "",
    "result": "https://vvd.bz/K56t"
}

Response Parameters

code integer
Code de réponse : 0 = Succès, autres valeurs = Erreur
message string
Message de réponse. Si le code n’est pas 0, un message d’erreur est renvoyé.
result string
Valeur de réponse. Le lien raccourci est renvoyé.
Exemple : https://vvd.bz/jH3d

Quand utiliser cette API

Utilisez l’API de génération de QR dans les cas suivants :

  • Lorsque vous devez générer des QR codes à grande échelle via des intégrations externes
  • Lorsque vous souhaitez créer des QR codes personnalisés avec les couleurs et le logo de votre marque
  • Lorsque vous devez générer des QR codes dynamiques pour des produits, cartes ou supports imprimés
  • Lorsque vous avez besoin de QR codes pour des URL, du texte ou des numéros de téléphone
Pensée pour l’automatisation et le volume—pas pour une création manuelle via le tableau de bord.

Types de QR code

L’API prend actuellement en charge les types de QR code suivants :

  • url : QR code contenant une URL. Jusqu’à 2 000 bytes
  • text : QR code contenant du texte. Jusqu’à 65 535 bytes
  • phone : QR code contenant un numéro de téléphone. Jusqu’à 32 caractères

Le tableau de bord propose d’autres types comme email ou WiFi, mais l’API reste pour l’instant limitée.
D’autres types seront ajoutés dans de futures mises à jour.

Cas d’utilisation

L’API de génération de QR s’adapte à de nombreux usages :

  • E-commerce : Générer automatiquement un QR par produit pour les emballages et étiquettes
  • Cartes de visite & supports imprimés : Créer des QR personnalisés avec couleurs et logo
  • Événements offline : Générer en masse des QR uniques pour billets et participants
  • Restaurants & commerces : Mettre à jour automatiquement les QR de menus et tables selon les modifications
Idéal pour offrir un accès rapide et fluide sur mobile.

Options de design et de style

Personnalisez entièrement l’apparence de vos QR codes.

Définissez les couleurs avec foreground (par défaut #000000FF), background (par défaut #FFFFFFFF), markerColor (par défaut #000000FF) et markerBorderColor (par défaut #000000).

Choisissez le style via style—rectangles, small-rectangles, dots, round, rows, columns, snakes, water—et ajustez les marqueurs avec markerStyle.

Ajoutez un logo en définissant logoType sur U (image personnalisée) ou C (logo par défaut). Disponible à partir du plan Personal.
Indiquez l’image via logo. Taille recommandée : jusqu’à 500×500px.

Points à considérer

Veuillez tenir compte des éléments suivants lors de la création de QR codes :

  • Un contraste de couleur insuffisant peut réduire la précision de lecture
  • Des designs trop complexes peuvent affecter les performances de scan
  • L’API ne prend actuellement en charge qu’un nombre limité de types de QR
Pour des résultats fiables, commencez avec les paramètres par défaut puis ajustez selon vos besoins.