Генерация QR‑кодов «на лету» имеет решающее значение для мобильных платежей, билетов на мероприятия и отслеживания запасов. Aspose.BarCode Cloud SDK for Python позволяет создавать QR‑коды высокого качества непосредственно из ваших Python‑приложений. В этом руководстве мы пройдем весь рабочий процесс Aspose.BarCode cloud Python QR‑кода, от настройки учетных данных до настройки цветов и встраивания логотипов. Вы также узнаете, как пакетно генерировать несколько кодов и использовать эквивалентные команды cURL для интеграции через REST. Библиотека Aspose.BarCode cloud Python QR‑кода также поддерживает добавление логотипов и настройку уровней коррекции ошибок для надёжного сканирования.

Перед началом: Предварительные требования и установка

Прежде чем начать, убедитесь, что у вас есть следующее:

  • Python 3.7 или выше, установленный на вашей машине разработки.
  • Учётная запись Aspose Cloud с значениями client_id и client_secret.
  • Доступ к папке, в которой будут сохранены сгенерированные файлы PNG.

Установите SDK с помощью pip:

pip install aspose-barcode-cloud

Скачайте последнюю версию пакета и просмотрите примечания к выпуску на странице страница загрузки.

Далее настройте клиент API, используя свои учетные данные (выдержка из полного скрипта):

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

После установки SDK и настройки учетных данных вы готовы генерировать QR‑коды.

Пошаговое руководство по созданию пользовательских QR‑кодов с помощью Aspose.BarCode Cloud SDK for Python

Это пошаговое руководство демонстрирует, как работать с Aspose.BarCode cloud Python QR code API для создания полностью настроенных QR‑изображений.

Шаг 1: Загрузите исходный документ и установите учетные данные

Сначала импортируйте необходимые модули и создайте экземпляр BarCodeApi, как показано выше. Это подготовит библиотеку к взаимодействию с сервисом Aspose cloud.

Шаг 2: Определите параметры QR‑кода

Создайте словарь, который содержит параметры QR‑кода, такие как тип, текст, формат, цвета и уровень коррекции ошибок.

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

Для получения более подробной информации о каждом параметре см. справка BarCode API.

Шаг 3: Вставьте необязательный логотип

Если вы хотите добавить логотип, прочитайте файл изображения, преобразуйте его в Base64 и добавьте его в параметры.

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)

Этот шаг демонстрирует возможность генерации QR‑кода с логотипом Aspose.BarCode sdk.

Шаг 4: Сгенерировать и сохранить QR‑код

Вызовите метод get_barcode_generate и запишите возвращаемые байты в файл.

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

Шаг 5: Пакетное создание нескольких QR‑кодов (необязательно)

Пройдите по списку текстов и имён файлов, чтобы создать несколько QR‑кодов за один запуск.

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)

Это иллюстрирует пакетную генерацию QR‑кодов Python Aspose в лаконичном цикле.

Полный пример кода: пакетная генерация QR‑кода с пользовательскими настройками

Следующий скрипт собирает все части вместе и демонстрирует процесс генерации QR‑кода 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()

Примечание: Этот пример кода демонстрирует базовый функционал. Прежде чем использовать его в вашем проекте, убедитесь, что обновили все пути к файлам и значения конфигурации в соответствии с вашей реальной средой, проверьте, что все необходимые зависимости правильно установлены, и тщательно протестируйте в вашей среде разработки. Если возникнут проблемы, обратитесь к официальной документации или свяжитесь с службой поддержки для получения помощи.

Генерация QR‑кодов через REST API с помощью cURL

Если вы предпочитаете чисто REST‑подход, вы можете использовать конечную точку Aspose.BarCode cloud Python QR code с командами cURL, чтобы достичь того же результата.

1. Получить токен доступа

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

Ответ содержит access_token, который вы будете использовать в последующих вызовах.

2. Создать QR‑код

Замените YOUR_ACCESS_TOKEN и при необходимости скорректируйте параметры запроса.

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

Чтобы встроить логотип, сначала преобразуйте изображение в Base64 и передайте его через параметр logo.

3. Пакетная генерация (пример цикла)

Вы можете написать скрипт цикла в Bash или PowerShell, который перебирает список текстов и вызывает вышеуказанный GET‑запрос для каждой записи, сохраняя результаты в файлы с разными именами.

Для получения полной информации об API обратитесь к официальной документации API.

Параметры настройки: цвета, логотип и коррекция ошибок

SDK предоставляет несколько параметров, позволяющих настроить внешний вид и устойчивость QR‑кода.

  • foreColor – Устанавливает цвет переднего плана (модуля). Пример: "DarkBlue".
  • backColor – Устанавливает цвет фона. Пример: "LightYellow".
  • qrErrorLevel – Управляет коррекцией ошибок. Доступные варианты: LevelL, LevelM, LevelQ, LevelH. Более высокие уровни повышают устойчивость за счёт ёмкости данных.
  • logo – Изображение в формате Base64, которое будет размещено в центре QR‑кода.

Ниже приведён фрагмент, показывающий, как эти параметры собираются в словаре запроса:

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

Отрегулируйте значения в соответствии с вашими руководящими принципами бренда или требованиями к визуальному дизайну.

Вопросы, которые у вас могут возникнуть

  • Как создать пользовательский QR‑код с помощью Aspose.BarCode Python без написания большого количества кода?
    SDK берет на себя всю сложную работу. Установив несколько параметров в словаре params и вызвав get_barcode_generate, вы получаете готовое к использованию QR‑изображение.

  • Можно ли генерировать QR‑код с логотипом с помощью Aspose.BarCode SDK на безсерверной платформе?
    Да. Библиотека работает в любой среде Python, включая AWS Lambda или Azure Functions, при условии, что среда выполнения может достичь https://api.aspose.cloud.

  • Что возвращает скрипт Python для генерации QR‑кода Aspose?
    Метод get_barcode_generate возвращает необработанные байты изображения, которые вы можете записать напрямую в файл или передать в поток веб‑ответа.

  • Как настроить цвета QR‑кода Aspose.BarCode Python под палитру моего бренда?
    Используйте параметры foreColor и backColor с любым именем цвета HTML или HEX‑значением, поддерживаемым API.

  • Какие варианты лицензирования и как получить временную лицензию?
    Полные лицензии доступны для покупки на сайте Aspose. Для оценки вы можете запросить временную лицензию на странице страница временной лицензии.

Подробнее