Créer des codes QR à la volée est essentiel pour les paiements mobiles, les billets d’événement et le suivi des stocks. Le Aspose.BarCode Cloud SDK for Python vous permet de créer des codes QR de haute qualité directement depuis vos applications Python. Dans ce guide, nous parcourrons le flux de travail du code QR Aspose.BarCode cloud Python, depuis la configuration des informations d’identification jusqu’à la personnalisation des couleurs et l’intégration de logos. Vous apprendrez également comment générer en lot plusieurs codes et utiliser des commandes cURL équivalentes pour l’intégration REST. La bibliothèque de code QR Aspose.BarCode cloud Python prend également en charge l’ajout de logos et l’ajustement des niveaux de correction d’erreur pour un scan fiable.

Avant de commencer : prérequis et installation

Avant de commencer, assurez‑vous d’avoir les éléments suivants :

  • Python 3.7 ou supérieur installé sur votre machine de développement.
  • Un compte Aspose Cloud avec les valeurs client_id et client_secret.
  • Accès à un dossier où les fichiers PNG générés seront enregistrés.

Installez le SDK via pip :

pip install aspose-barcode-cloud

Téléchargez le dernier package et consultez les notes de version sur la page de téléchargement.

Ensuite, configurez le client API avec vos informations d’identification (extrait du script complet) :

from asposebarcodecloud import BarCodeApi, ApiClient, Configuration

API_CLIENT_ID = "YOUR_CLIENT_ID"
API_CLIENT_SECRET = "YOUR_CLIENT_SECRET"

config = Configuration()
config.host = "https://api.aspose.cloud"
config.api_key['client_id'] = API_CLIENT_ID
config.api_key['client_secret'] = API_CLIENT_SECRET

barcode_api = BarCodeApi(ApiClient(config))

Avec le SDK installé et les informations d’identification configurées, vous êtes prêt à générer des codes QR.

Guide étape par étape pour générer des codes QR personnalisés avec Aspose.BarCode Cloud SDK for Python

Ce guide pas à pas montre comment travailler avec l’API QR code Python du cloud Aspose.BarCode pour créer des images QR entièrement personnalisées.

Étape 1 : charger le document source et définir les informations d’identification

Tout d’abord, importez les modules requis et créez l’instance BarCodeApi comme indiqué ci-dessus. Cela prépare la bibliothèque à communiquer avec le service cloud Aspose.

Étape 2 : Définir les paramètres du code QR

Créez un dictionnaire qui contient les options du code QR telles que le type, le texte, le format, les couleurs et le niveau de correction d’erreur.

params = {
    "type": "QR",
    "text": "https://example.com",
    "format": "png",
    "foreColor": "Black",
    "backColor": "White",
    "qrErrorLevel": "LevelQ"
}

Pour plus de détails sur chaque paramètre, consultez la référence de l’API BarCode.

Étape 3 : Intégrer un logo facultatif

Si vous souhaitez ajouter un logo, lisez le fichier image, convertissez‑le en Base64 et ajoutez‑le aux paramètres.

def read_logo_as_base64(logo_path: str) -> str:
    with open(logo_path, "rb") as logo_file:
        return base64.b64encode(logo_file.read()).decode('utf-8')

if logo_path and os.path.isfile(logo_path):
    params["logo"] = read_logo_as_base64(logo_path)

Cette étape démontre la capacité de générer un code QR avec le logo Aspose.BarCode sdk.

Étape 4 : Générer et enregistrer le code QR

Appelez la méthode get_barcode_generate et écrivez les octets retournés dans un fichier.

result_bytes = barcode_api.get_barcode_generate(**params)
with open(output_path, "wb") as out_file:
    out_file.write(result_bytes)
print(f"QR code saved to: {output_path}")

Étape 5 : Générer en lot plusieurs codes QR (facultatif)

Parcourir une liste de textes et de noms de fichiers pour créer plusieurs codes QR en une seule exécution.

qr_items = [
    {"text": "https://example.com/product/1", "filename": "qr_product_1.png"},
    {"text": "Contact: +1-800-555-0199", "filename": "qr_contact.png"}
]

for item in qr_items:
    output_file = os.path.join("generated_qrcodes", item["filename"])
    generate_qr_code(text=item["text"], output_path=output_file, **common_settings)

Cela illustre batch generate QR codes Python Aspose dans une boucle concise.

Exemple complet de code : génération de QR Code par lot avec paramètres personnalisés

Le script suivant rassemble tous les éléments et démontre le processus de génération de codes QR avec prise en charge du lot à l’aide d’Aspose.BarCode cloud Python.

import os
import base64
from asposebarcodecloud import BarCodeApi, ApiClient, Configuration, ApiException

# -------------------- Configuration --------------------
# Replace with your actual Aspose Cloud credentials
API_CLIENT_ID = "YOUR_CLIENT_ID"
API_CLIENT_SECRET = "YOUR_CLIENT_SECRET"

config = Configuration()
config.host = "https://api.aspose.cloud"
config.api_key['client_id'] = API_CLIENT_ID
config.api_key['client_secret'] = API_CLIENT_SECRET

# Initialize API instance
barcode_api = BarCodeApi(ApiClient(config))

# -------------------- Helper Functions --------------------
def read_logo_as_base64(logo_path: str) -> str:
    """Read an image file and return its Base64 representation."""
    with open(logo_path, "rb") as logo_file:
        return base64.b64encode(logo_file.read()).decode('utf-8')

def generate_qr_code(
    text: str,
    output_path: str,
    fore_color: str = "Black",
    back_color: str = "White",
    error_correction: str = "LevelQ",   # Options: LevelL, LevelM, LevelQ, LevelH
    logo_path: str = None,
    image_format: str = "png"
) -> None:
    """
    Generates a QR code with optional customizations and saves it to disk.
    """
    try:
        # Prepare optional parameters
        params = {
            "type": "QR",
            "text": text,
            "format": image_format,
            "foreColor": fore_color,
            "backColor": back_color,
            "qrErrorLevel": error_correction
        }

# If a logo is supplied, embed it as a Base64 string
        if logo_path and os.path.isfile(logo_path):
            params["logo"] = read_logo_as_base64(logo_path)

# Call the Aspose.BarCode Cloud API
        result_bytes = barcode_api.get_barcode_generate(**params)

# Write the resulting image to the specified file
        with open(output_path, "wb") as out_file:
            out_file.write(result_bytes)

print(f"QR code saved to: {output_path}")

except ApiException as e:
        print(f"API Exception when generating QR for '{text}': {e}")

# -------------------- Batch Generation Example --------------------
def batch_generate_qr_codes():
    """
    Generates multiple QR codes in a loop with varying texts and customizations.
    """
    # Sample data for batch processing
    qr_items = [
        {"text": "https://example.com/product/1", "filename": "qr_product_1.png"},
        {"text": "https://example.com/product/2", "filename": "qr_product_2.png"},
        {"text": "https://example.com/product/3", "filename": "qr_product_3.png"},
        {"text": "Contact: +1-800-555-0199", "filename": "qr_contact.png"},
        {"text": "Wi‑Fi: MyNetwork;P:password123;;", "filename": "qr_wifi.png"}
    ]

# Common customization settings
    fore_color = "DarkBlue"
    back_color = "LightYellow"
    error_correction = "LevelH"
    logo_path = "logo.png"   # Ensure this file exists in the working directory

output_dir = "generated_qrcodes"
    os.makedirs(output_dir, exist_ok=True)

for item in qr_items:
        output_file = os.path.join(output_dir, item["filename"])
        generate_qr_code(
            text=item["text"],
            output_path=output_file,
            fore_color=fore_color,
            back_color=back_color,
            error_correction=error_correction,
            logo_path=logo_path,
            image_format="png"
        )

# -------------------- Execution --------------------
if __name__ == "__main__":
    batch_generate_qr_codes()

Remarque : Cet exemple de code montre la fonctionnalité principale. Avant de l’utiliser dans votre projet, assurez‑vous de mettre à jour tous les chemins de fichiers et les valeurs de configuration pour qu’ils correspondent à votre environnement réel, vérifiez que toutes les dépendances requises sont correctement installées, et testez soigneusement dans votre environnement de développement. Si vous rencontrez des problèmes, veuillez consulter la documentation officielle ou contacter l’équipe de support pour obtenir de l’aide.

Génération de codes QR via l’API REST avec cURL

Si vous préférez une approche pure REST, vous pouvez utiliser le point de terminaison QR code Python du cloud Aspose.BarCode avec des commandes cURL pour obtenir le même résultat.

1. Obtenir un jeton d’accès

curl -X POST "https://api.aspose.cloud/connect/token" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"

La réponse contient un access_token que vous utiliserez dans les appels ultérieurs.

2. Générer un code QR

Remplacez YOUR_ACCESS_TOKEN et ajustez les paramètres de requête si nécessaire.

curl -X GET "https://api.aspose.cloud/v3.0/barcode/generate?type=QR&text=HelloWorld&format=png&foreColor=DarkBlue&backColor=LightYellow&qrErrorLevel=LevelH" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o qr_helloworld.png

Pour intégrer un logo, convertissez d’abord l’image en Base64 et transmettez‑la via le paramètre logo.

3. Génération par lots (exemple de boucle)

Vous pouvez écrire un script de boucle en Bash ou PowerShell qui parcourt une liste de textes et appelle la requête GET ci‑dessus pour chaque entrée, en enregistrant les résultats avec des noms de fichiers distincts.

Pour plus de détails sur l’API, consultez la documentation officielle de l’API.

Options de personnalisation : Couleurs, logo et correction d’erreurs

Le SDK expose plusieurs paramètres qui vous permettent d’adapter l’apparence et la résilience du code QR.

  • foreColor - Définit la couleur de premier plan (module). Exemple : "DarkBlue".
  • backColor - Définit la couleur d’arrière-plan. Exemple : "LightYellow".
  • qrErrorLevel - Contrôle la correction d’erreurs. Les options sont LevelL, LevelM, LevelQ, LevelH. Des niveaux plus élevés augmentent la robustesse au détriment de la capacité de données.
  • logo - Une image encodée en Base64 qui sera placée au centre du code QR.

Voici un extrait montrant comment ces options sont assemblées dans le dictionnaire de requête :

params = {
    "type": "QR",
    "text": "https://example.com",
    "format": "png",
    "foreColor": "DarkBlue",
    "backColor": "LightYellow",
    "qrErrorLevel": "LevelH",
    "logo": read_logo_as_base64("logo.png")  # optional
}

Ajustez les valeurs pour qu’elles correspondent à vos directives de marque ou à vos exigences de conception visuelle.

Questions que vous pourriez avoir

  • Comment créer un code QR personnalisé avec Aspose.BarCode Python sans écrire beaucoup de code ?
    Le SDK prend en charge les opérations complexes. En définissant quelques paramètres dans le dictionnaire params et en appelant get_barcode_generate, vous obtenez une image QR prête à l’emploi.

  • Est-il possible de générer un code QR avec logo Aspose.BarCode SDK sur une plateforme serverless ?
    Oui. La bibliothèque fonctionne dans n’importe quel environnement Python, y compris AWS Lambda ou Azure Functions, tant que le runtime peut atteindre https://api.aspose.cloud.

  • Que renvoie le script python pour la génération de QR code Aspose ?
    La méthode get_barcode_generate renvoie les octets bruts de l’image, que vous pouvez écrire directement dans un fichier ou diffuser dans une réponse web.

  • Comment personnaliser les couleurs du code QR Aspose.BarCode Python pour la palette de ma marque ?
    Utilisez les paramètres foreColor et backColor avec n’importe quel nom de couleur HTML ou valeur HEX prise en charge par l’API.

  • Quelles sont les options de licence et comment puis‑je obtenir une licence temporaire ?
    Les licences complètes sont disponibles à l’achat sur le site Web d’Aspose. Pour l’évaluation, vous pouvez demander une licence temporaire depuis la page de licence temporaire.

En savoir plus