At generere QR‑koder på farten er vigtigt for mobilbetalinger, eventbilletter og lagerstyring. Aspose.BarCode Cloud SDK for Python giver dig mulighed for at oprette QR‑koder af høj kvalitet direkte fra dine Python‑applikationer. I denne vejledning gennemgår vi Aspose.BarCode cloud Python QR‑kode‑arbejdsgang, fra opsætning af legitimationsoplysninger til tilpasning af farver og indlejring af logoer. Du lærer også, hvordan du batch‑genererer flere koder og bruger tilsvarende cURL‑kommandoer til REST‑integration. Aspose.BarCode cloud Python QR‑kode‑biblioteket understøtter også tilføjelse af logoer og justering af fejlkorrigeringsniveauer for robust scanning.

Før du starter: Forudsætninger og installation

Før du begynder, skal du sikre dig, at du har følgende:

  • Python 3.7 eller højere installeret på din udviklingsmaskine.
  • En Aspose Cloud-konto med client_id og client_secret værdier.
  • Adgang til en mappe, hvor de genererede PNG filer vil blive gemt.

Installer SDK’en via pip:

pip install aspose-barcode-cloud

Download den seneste pakke og se udgivelsesnoterne på download-siden.

Derefter skal du konfigurere API‑klienten med dine legitimationsoplysninger (uddrag fra det fulde script):

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

Med SDK’en installeret og legitimationsoplysningerne indstillet, er du klar til at generere QR‑koder.

Trin-for-trin guide til at generere brugerdefinerede QR-koder med Aspose.BarCode Cloud SDK for Python

Denne trin‑for‑trin guide demonstrerer, hvordan man arbejder med Aspose.BarCode cloud Python QR‑kode‑API for at producere fuldt tilpassede QR‑billeder.

Trin 1: Indlæs kilde‑dokumentet og indstil legitimationsoplysninger

Først importerer du de nødvendige moduler og opretter BarCodeApi‑instansen som vist ovenfor. Dette forbereder biblioteket til at kommunikere med Aspose cloud service.

Trin 2: Definer QR‑kodeparametre

Opret en ordbog, der indeholder QR‑kodeindstillinger såsom type, tekst, format, farver og fejlkorrigeringsniveau.

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

For flere detaljer om hver parameter, se BarCode API‑referencen.

Hvis du vil tilføje et logo, skal du læse billedfilen, konvertere den til Base64 og tilføje den til parametrene.

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)

Dette trin demonstrerer generere QR‑kode med logo Aspose.BarCode sdk‑kapaciteten.

Trin 4: Generer og gem QR‑koden

Kald get_barcode_generate-metoden og skriv de returnerede bytes til en fil.

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

Trin 5: Batch‑generer flere QR‑koder (Valgfrit)

Loop gennem en liste af tekster og filnavne for at oprette flere QR‑koder i én kørsel.

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)

Dette illustrerer batch generate QR codes Python Aspose i en kortfattet løkke.

Komplet kodeeksempel: Batch QR‑kodegenerering med brugerdefinerede indstillinger

Det følgende script samler alle delene og demonstrerer Aspose.BarCode cloud Python QR‑kodegenereringsprocessen med batch‑understøttelse.

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

Note: Dette kodeeksempel demonstrerer kernefunktionaliteten. Før du bruger det i dit projekt, skal du sikre dig, at du opdaterer eventuelle filstier og konfigurationsværdier, så de matcher dit faktiske miljø, bekræfte at alle nødvendige afhængigheder er korrekt installeret, og teste grundigt i dit udviklingsmiljø. Hvis du støder på problemer, så se venligst den officielle dokumentation eller kontakt supportteamet for assistance.

Generering af QR‑koder via REST API med cURL

Hvis du foretrækker en ren REST‑tilgang, kan du bruge Aspose.BarCode cloud Python QR code endpoint med cURL‑kommandoer for at opnå det samme resultat.

1. Få en adgangstoken

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

Svaret indeholder et access_token, som du vil bruge i efterfølgende kald.

2. Generer en QR‑kode

Erstat YOUR_ACCESS_TOKEN og juster forespørgselsparametrene efter behov.

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

For at indlejre et logo, skal du først konvertere billedet til Base64 og videregive det via logo‑parameteren.

3. Batch-generering (Loop-eksempel)

Du kan skrive et script i Bash eller PowerShell, der itererer over en liste af tekster og kalder den ovenstående GET‑anmodning for hver post, og gemmer resultaterne med forskellige filnavne.

For fulde API-detaljer, se den officielle API-dokumentation.

Tilpasningsmuligheder: Farver, logo og fejlkorrigering

SDK’en giver adgang til flere parametre, som gør det muligt at tilpasse udseendet og robustheden af QR‑koden.

  • foreColor - Angiver forgrundsfarven (modul). Eksempel: "DarkBlue".
  • backColor - Angiver baggrundsfarven. Eksempel: "LightYellow".
  • qrErrorLevel - Styrer fejlkorrigering. Mulighederne er LevelL, LevelM, LevelQ, LevelH. Højere niveauer øger robustheden på bekostning af datakapacitet.
  • logo - Et Base64‑kodet billede, der placeres i midten af QR‑koden.

Nedenfor er et uddrag, der viser, hvordan disse indstillinger samles i anmodningsordbogen:

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

Juster værdierne, så de matcher dine retningslinjer for branding eller visuelle designkrav.

Spørgsmål du måske har

  • Hvordan kan jeg oprette en brugerdefineret QR‑kode ved hjælp af Aspose.BarCode Python uden at skrive meget kode?
    SDK’en abstraherer det tunge løft. Ved at indstille nogle få parametre i params‑ordbogen og kalde get_barcode_generate, får du et klar‑til‑brug QR‑billede.

  • Er det muligt at generere QR‑kode med logo ved hjælp af Aspose.BarCode SDK på en serverløs platform?
    Ja. Biblioteket fungerer i ethvert Python‑miljø, herunder AWS Lambda eller Azure Functions, så længe runtime kan nå https://api.aspose.cloud.

  • Hvad returnerer python‑scriptet til QR‑kodegenerering Aspose?
    Metoden get_barcode_generate returnerer de rå billed‑bytes, som du kan skrive direkte til en fil eller streame til et web‑respons.

  • Hvordan tilpasser jeg QR‑kodens farver i Aspose.BarCode Python til min virksomheds farvepalette?
    Brug foreColor og backColor parametrene med ethvert HTML farvenavn eller HEX‑værdi, som API’en understøtter.

  • Hvad er licensmulighederne, og hvordan kan jeg få en midlertidig licens?
    Fuldlicenser kan købes på Aspose-webstedet. Til evaluering kan du anmode om en midlertidig licens fra den midlertidige licensside.

Læs mere