Generare codici QR al volo è essenziale per i pagamenti mobili, i biglietti per eventi e il tracciamento dell’inventario. L’Aspose.BarCode Cloud SDK for Python consente di creare codici QR di alta qualità direttamente dalle tue applicazioni Python. In questa guida percorreremo il Aspose.BarCode cloud Python QR code workflow, dalla configurazione delle credenziali alla personalizzazione dei colori e all’inserimento di loghi. Imparerai anche come generare in batch più codici e utilizzare comandi cURL equivalenti per l’integrazione REST. La Aspose.BarCode cloud Python QR code library supporta inoltre l’aggiunta di loghi e la regolazione dei livelli di correzione degli errori per una scansione affidabile.

Prima di iniziare: Prerequisiti e installazione

Prima di iniziare, assicurati di avere quanto segue:

  • Python 3.7 o versioni successive installato sulla tua macchina di sviluppo.
  • Un account Aspose Cloud con i valori client_id e client_secret.
  • Accesso a una cartella dove i file PNG generati verranno salvati.

Installa l’SDK tramite pip:

pip install aspose-barcode-cloud

Scarica l’ultimo pacchetto e visualizza le note di rilascio nella pagina di download.

Successivamente, configura il client API con le tue credenziali (estratto dallo script completo):

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))

Con l’SDK installato e le credenziali configurate, sei pronto a generare codici QR.

Guida passo-passo per generare codici QR personalizzati con Aspose.BarCode Cloud SDK for Python

Questa guida passo‑passo dimostra come utilizzare l’API QR code di Aspose.BarCode cloud per Python per creare immagini QR completamente personalizzate.

Passo 1: Carica il documento di origine e imposta le credenziali

Per prima cosa, importa i moduli richiesti e crea l’istanza BarCodeApi come mostrato sopra. Questo prepara la libreria per comunicare con il servizio cloud di Aspose.

Passo 2: Definisci i parametri del codice QR

Crea un dizionario che contiene le opzioni del codice QR come tipo, testo, formato, colori e livello di correzione degli errori.

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

Per ulteriori dettagli su ciascun parametro, consulta il riferimento API BarCode.

Passo 3: Inserisci un logo opzionale

Se vuoi aggiungere un logo, leggi il file immagine, convertilo in Base64 e aggiungilo ai parametri.

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)

Questo passaggio dimostra la funzionalità genera codice QR con logo Aspose.BarCode sdk.

Passo 4: Genera e salva il codice QR

Chiama il metodo get_barcode_generate e scrivi i byte restituiti in un file.

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}")

Passo 5: Genera più codici QR in batch (Opzionale)

Scorri un elenco di testi e nomi di file per creare diversi codici QR in un’unica esecuzione.

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)

Questo illustra generazione batch di codici QR Python Aspose in un ciclo conciso.

Esempio di Codice Completo: Generazione di Codici QR in Batch con Impostazioni Personalizzate

Lo script seguente mette insieme tutti i componenti e dimostra il processo di generazione di codici QR con supporto batch di 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()

Nota: Questo esempio di codice dimostra la funzionalità principale. Prima di usarlo nel tuo progetto, assicurati di aggiornare tutti i percorsi dei file e i valori di configurazione per corrispondere al tuo ambiente reale, verifica che tutte le dipendenze richieste siano installate correttamente e testa accuratamente nel tuo ambiente di sviluppo. Se incontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Generazione di codici QR tramite REST API con cURL

Se preferisci un approccio REST puro, puoi utilizzare l’Aspose.BarCode cloud Python QR code endpoint con comandi cURL per ottenere lo stesso risultato.

1. Ottenere un token di accesso

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 risposta contiene un access_token che utilizzerai nelle chiamate successive.

2. Genera un codice QR

Sostituisci YOUR_ACCESS_TOKEN e regola i parametri di query secondo necessità.

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

Per incorporare un logo, prima converti l’immagine in Base64 e passala tramite il parametro logo.

3. Generazione batch (esempio di ciclo)

Puoi scrivere uno script di loop in Bash o PowerShell che itera su un elenco di testi e chiama la richiesta GET sopra per ogni voce, salvando i risultati con nomi file distinti.

Per i dettagli completi dell’API, consultare la documentazione ufficiale dell’API.

Opzioni di personalizzazione: colori, logo e correzione degli errori

L’SDK espone diversi parametri che consentono di personalizzare l’aspetto e la resilienza del codice QR.

  • foreColor - Imposta il colore di primo piano (modulo). Esempio: "DarkBlue".
  • backColor - Imposta il colore di sfondo. Esempio: "LightYellow".
  • qrErrorLevel - Controlla la correzione degli errori. Le opzioni sono LevelL, LevelM, LevelQ, LevelH. I livelli più alti aumentano la robustezza a scapito della capacità dei dati.
  • logo - Un’immagine codificata in Base64 che verrà posizionata al centro del codice QR.

Di seguito è riportato uno snippet che mostra come queste opzioni vengono assemblate nel dizionario della richiesta:

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

Regola i valori per farli corrispondere alle linee guida del tuo brand o ai requisiti di design visivo.

Domande che potresti avere

  • Come posso creare un codice QR personalizzato usando Aspose.BarCode Python senza scrivere molto codice?
    L’SDK astrae la parte più complessa. Impostando alcuni parametri nel dizionario params e chiamando get_barcode_generate, ottieni un’immagine QR pronta all’uso.

  • È possibile generare un codice QR con logo usando Aspose.BarCode SDK su una piattaforma serverless?
    Sì. La libreria funziona in qualsiasi ambiente Python, inclusi AWS Lambda o Azure Functions, purché il runtime possa raggiungere https://api.aspose.cloud.

  • Cosa restituisce lo script Python per la generazione di codici QR Aspose?
    Il metodo get_barcode_generate restituisce i byte grezzi dell’immagine, che è possibile scrivere direttamente su un file o trasmettere in risposta web.

  • Come personalizzare i colori del codice QR Aspose.BarCode Python per la palette del mio brand?
    Utilizza i parametri foreColor e backColor con qualsiasi nome colore HTML o valore HEX supportato dall’API.

  • Quali sono le opzioni di licenza e come posso ottenere una licenza temporanea?
    Le licenze complete sono disponibili per l’acquisto sul sito web di Aspose. Per la valutazione, è possibile richiedere una licenza temporanea dalla pagina della licenza temporanea.

Leggi di più