Aller au contenu

Modèles

Le moteur est livré avec une sélection de modèles : des objets QrConfig préconfigurés que vous appelez par identifiant. Utilisez-les quand vous voulez un rendu garanti sans rien concevoir à la main.

Lister les modèles

GET /api/qr/templates
{
  "success": true,
  "count": 118,
  "templates": [
    {
      "id": "champagne-onyx",
      "name": "Champagne on Onyx",
      "category": "luxury",
      "tags": ["dark", "monogram", "premium"],
      "preview": "https://api.qr-branding.com/api/qr/templates/champagne-onyx/preview"
    },
    { "...": "..." }
  ]
}

Filtrer par catégorie

GET /api/qr/templates?category=luxury

La structure de la réponse est identique à celle de l'appel sans filtre, mais elle ne contient que les correspondances. Les catégories ne tiennent pas compte de la casse et correspondent au champ category de chaque modèle. Consultez la liste à jour dans l'onglet « Templates » de /examples.

Générer à partir d'un modèle

POST /api/qr/templates/{templateId}

Le corps est un sous-ensemble de QrConfig : tout ce que vous définissez remplace les valeurs par défaut du modèle. La plupart des appelants ne remplacent que content, outputWidth et fileFormat.

Remplacements courants

ChampPourquoi le remplacer
contentL'URL ou le texte à encoder : presque toujours remplacé
outputWidthRésolution d'impression (1200, 2400, 4096)
fileFormatpdf ou svg pour l'impression, png pour l'écran
logoUrlPlacer votre logo sur n'importe quel modèle
centerTextAjouter un bandeau « ADMIT ONE » / « SCAN ME »
ctaTextLégende en dessous

Galerie visuelle

Tous les modèles rendus côte à côte se trouvent sur /examples ; la même galerie est aussi incluse dans la référence visuelle pour une consultation hors ligne.