QR kodlarını anında oluşturmak, mobil ödemeler, etkinlik biletleri ve envanter takibi için çok önemlidir. Aspose.BarCode Cloud SDK for Python Python uygulamalarınızdan yüksek kaliteli QR kodları doğrudan oluşturmanıza olanak tanır. Bu rehberde, Aspose.BarCode cloud Python QR code workflow’u, kimlik bilgilerini ayarlamaktan renkleri özelleştirmeye ve logoları eklemeye kadar adım adım inceleyeceğiz. Ayrıca birden fazla kodu toplu olarak oluşturmayı ve REST entegrasyonu için eşdeğer cURL komutlarını kullanmayı öğreneceksiniz. Aspose.BarCode cloud Python QR code library ayrıca logolar eklemeyi ve sağlam tarama için hata düzeltme seviyelerini ayarlamayı da destekler.
Başlamadan Önce: Gereksinimler ve Kurulum
Başlamadan önce, aşağıdakilere sahip olduğunuzdan emin olun:
- Python 3.7 veya üzeri, geliştirme makinenize kurulu.
- client_id ve client_secret değerlerine sahip bir Aspose Cloud hesabı.
- Oluşturulan PNG dosyalarının kaydedileceği bir klasöre erişim.
SDK’yı pip ile kurun:
pip install aspose-barcode-cloud
En son paketi indirin ve sürüm notlarını indirme sayfasında görüntüleyin.
Sonra, API istemcisini kimlik bilgilerinizle yapılandırın (tam betikten bir alıntı):
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 yüklü ve kimlik bilgileri ayarlandığında, QR kodları oluşturmak için hazırsınız.
Aspose.BarCode Cloud SDK for Python ile Özel QR Kodları Oluşturmak için Adım Adım Kılavuz
Bu adım‑adım kılavuz, Aspose.BarCode cloud Python QR code API ile tam özelleştirilmiş QR görüntüleri üretmeyi gösterir.
Adım 1: Kaynak Belgeyi Yükleyin ve Kimlik Bilgilerini Ayarlayın
İlk olarak, gerekli modülleri içe aktarın ve yukarıda gösterildiği gibi BarCodeApi örneğini oluşturun. Bu, kütüphanenin Aspose bulut hizmetiyle iletişim kurmasını hazırlar.
Adım 2: QR Kod Parametrelerini Tanımla
Tip, metin, format, renkler ve hata düzeltme seviyesi gibi QR kod seçeneklerini tutan bir sözlük oluşturun.
params = {
"type": "QR",
"text": "https://example.com",
"format": "png",
"foreColor": "Black",
"backColor": "White",
"qrErrorLevel": "LevelQ"
}
Her parametre hakkında daha fazla ayrıntı için, BarCode API referansı sayfasına bakın.
Adım 3: İsteğe Bağlı Logo Yerleştir
Bir logo eklemek istiyorsanız, görüntü dosyasını okuyun, Base64’e dönüştürün ve parametrelere ekleyin.
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)
Bu adım, logo ile QR kod oluşturma Aspose.BarCode sdk yeteneğini gösterir.
Adım 4: QR Kodunu Oluştur ve Kaydet
get_barcode_generate yöntemini çağırın ve döndürülen baytları bir dosyaya yazın.
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}")
Adım 5: Birden Çok QR Kodu Toplu Olarak Oluşturma (İsteğe Bağlı)
Metinler ve dosya adları listesini döngüyle işleyerek tek bir çalıştırmada birden fazla QR kodu oluşturun.
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)
Bu, toplu QR kodları oluşturma Python Aspose‘i kısa bir döngüde gösterir.
Tam Kod Örneği: Özel Ayarlarla Toplu QR Kodu Oluşturma
Aşağıdaki betik tüm parçaları bir araya getirir ve Aspose.BarCode cloud Python QR kodu oluşturma sürecini toplu destekle gösterir.
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()
Not: Bu kod örneği temel işlevselliği gösterir. Projenizde kullanmadan önce, dosya yollarını ve yapılandırma değerlerini gerçek ortamınıza uygun şekilde güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğinden emin olun ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen resmi dokümantasyona bakın veya yardım için destek ekibi ile iletişime geçin.
cURL ile REST API üzerinden QR Kodları Oluşturma
Eğer saf bir REST yaklaşımını tercih ediyorsanız, aynı sonucu elde etmek için cURL komutlarıyla Aspose.BarCode cloud Python QR code endpoint’ini kullanabilirsiniz.
1. Erişim Token’ı Al
curl -X POST "https://api.aspose.cloud/connect/token" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
Yanıt, sonraki çağrılarda kullanacağınız bir access_token içerir.
2. QR Kodu Oluştur
YOUR_ACCESS_TOKEN değerini değiştirin ve sorgu parametrelerini gerektiği gibi ayarlayın.
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
Bir logo eklemek için, önce görüntüyü Base64’e dönüştürün ve logo parametresi aracılığıyla geçirin.
3. Toplu Oluşturma (Döngü Örneği)
Bash veya PowerShell’de bir döngü betiği yazarak, bir metin listesi üzerinde yineleme yapabilir ve her giriş için yukarıdaki GET isteğini çağırarak sonuçları farklı dosya adlarıyla kaydedebilirsiniz.
Tam API ayrıntıları için, resmi API belgelerine bakın.
Özelleştirme Seçenekleri: Renkler, Logo ve Hata Düzeltme
SDK, QR kodunun görünümünü ve dayanıklılığını özelleştirmenizi sağlayan çeşitli parametreler sunar.
- foreColor - Ön plan (modül) rengini ayarlar. Örnek:
"DarkBlue". - backColor - Arka plan rengini ayarlar. Örnek:
"LightYellow". - qrErrorLevel - Hata düzeltmeyi kontrol eder. Seçenekler
LevelL,LevelM,LevelQ,LevelH. Daha yüksek seviyeler, veri kapasitesi pahasına dayanıklılığı artırır. - logo - QR kodunun ortasına yerleştirilecek Base64‑kodlu bir görüntü.
Aşağıda, bu seçeneklerin istek sözlüğünde nasıl birleştirildiğini gösteren bir kod parçacığı bulunmaktadır:
params = {
"type": "QR",
"text": "https://example.com",
"format": "png",
"foreColor": "DarkBlue",
"backColor": "LightYellow",
"qrErrorLevel": "LevelH",
"logo": read_logo_as_base64("logo.png") # optional
}
Değerleri, marka yönergelerinize veya görsel tasarım gereksinimlerinize uygun şekilde ayarlayın.
Sahip Olabileceğiniz Sorular
-
Aspose.BarCode Python kullanarak çok fazla kod yazmadan özel QR kodu nasıl oluşturabilirim?
SDK, ağır işleri soyutlar.paramssözlüğünde birkaç parametre ayarlayıpget_barcode_generatemetodunu çağırarak, kullanıma hazır bir QR görüntüsü elde edersiniz. -
Sunucusuz bir platformda logo ile QR kod oluşturmak Aspose.BarCode SDK ile mümkün mü?
Evet. Kütüphane, çalışma zamanınınhttps://api.aspose.cloudadresine ulaşabildiği sürece, AWS Lambda veya Azure Functions dahil herhangi bir Python ortamında çalışır. -
Aspose QR kod oluşturma için python betiği ne döndürür?
get_barcode_generateyöntemi ham görüntü baytlarını döndürür; bunları doğrudan bir dosyaya yazabilir veya bir web yanıtına akıtabilirsiniz. -
Markamın renk paleti için Aspose.BarCode Python’da QR kod renklerini nasıl özelleştirebilirim?
API tarafından desteklenen herhangi bir HTML renk adı veya HEX değeriyleforeColorvebackColorparametrelerini kullanın. -
Lisans seçenekleri nelerdir ve geçici bir lisans nasıl alabilirim?
Tam lisanslar Aspose web sitesinden satın alınabilir. Değerlendirme için, geçici lisans sayfasından geçici bir lisans talep edebilirsiniz.