CloudmersiveBarcode API'yi Anlama

Cloudmersive, belge dönüşümü, OCR, görüntü işleme ve barkod işlemlerini içeren bir REST API koleksiyonu sunar. Barkod işlevselliği, daha geniş bir API portföyünün bir parçasıdır. .NET geliştiricileri için, Cloudmersive, REST uç noktalarını saran bir NuGet istemci paketi sağlar:

// NuGet: dotnet add package Cloudmersive.APIClient.NET.Barcode
using Cloudmersive.APIClient.NET.Barcode.Api;
using Cloudmersive.APIClient.NET.Barcode.Client;

Configuration.Default.ApiKey.Add("Apikey", "YOUR-CLOUDMERSIVE-API-KEY");
var apiInstance = new GenerateBarcodeApi();

// Each call issues an HTTPS request to Cloudmersive's servers
byte[] result = apiInstance.GenerateBarcodeQRCode("https://example.com");

// NuGet: dotnet add package Cloudmersive.APIClient.NET.Barcode
using Cloudmersive.APIClient.NET.Barcode.Api;
using Cloudmersive.APIClient.NET.Barcode.Client;

Configuration.Default.ApiKey.Add("Apikey", "YOUR-CLOUDMERSIVE-API-KEY");
var apiInstance = new GenerateBarcodeApi();

// Each call issues an HTTPS request to Cloudmersive's servers
byte[] result = apiInstance.GenerateBarcodeQRCode("https://example.com");

Imports Cloudmersive.APIClient.NET.Barcode.Api
Imports Cloudmersive.APIClient.NET.Barcode.Client

Configuration.Default.ApiKey.Add("Apikey", "YOUR-CLOUDMERSIVE-API-KEY")
Dim apiInstance As New GenerateBarcodeApi()

' Each call issues an HTTPS request to Cloudmersive's servers
Dim result As Byte() = apiInstance.GenerateBarcodeQRCode("https://example.com")

Bu kod hakkında anlaşılması gereken önemli şey, gerçekte ne yaptığıdır:Cloudmersivealtyapısına bir HTTPS isteği gönderir, bir yanıt bekler ve sonucu döndürür.Cloudmersiveentegrasyonundaki her barkod çalışma satırı bu modeli izler. Yerel işleme yoktur. Çevrimdışı yol yoktur. Her işlem etkin bir internet bağlantısına ve kullanılabilir birCloudmersivesunucusuna bağlıdır.

Masraf Ölçeklendirme

Cloudmersive, işlem başına fiyatlandırma kullanır. Her isteğin tam masrafı abonelik seviyenize bağlıdır, ancak temel model her seviyede aynıdır: her barkod işlemi aylık kotanızdan bir istek tüketir.

Cloudmersive'ın yayımlanan seviyelerine haritalanan yaygın üretim hacimleri üzerindeki matematik:

$749 (Lite, tek geliştirici) olan IronBarcode sürekli lisansı sınırsız barkod işlemlerini kapsar. Herhangi bir hacimde işlem başına ücret yoktur. Bir ekip, günde 10.000 barkod işleyen, yalnızca ilk altı hafta içinde Cloudmersive'ın yıllık olarak ödeyeceği lisans maliyetini dengeler.

3 geliştiriciden oluşan bir ekip için, tek bir ödeme ile olan 1.499 dolarlık Plus lisansı, günde 10.000 barkoddan yaklaşık 6.000 dolara kıyasla karşılaştırılır.IronBarcode lisansı,Cloudmersivetasarrufları yoluyla üç ay içinde kendini öder.

Gecikme Etkisi

HerCloudmersivebarkod işlemi şunları içerir:

1. İstek seri hale getirilmesi (görüntü baytları veya barkod verileri)
2. Bir HTTPS bağlantısı kurulması veya yeniden kullanılması
3. VerilerinCloudmersivesunucularına iletilmesi
4. Sunucu tarafı işleme için bekleme
5. Yanıtın alınması
6. Sonucun seri hale getirilmesi

Cloudmersive'ın yayımlanan rehberi ve müşteri raporları çağrı başına gecikmeyi yaklaşık 150–400ms olarak koyar, sunucu yüküne, coğrafi yakınlığa ve görüntü boyutuna bağlı olarak. Çağrı başına 250ms'de:

Kullanıcıya yönelik uç noktalar için — bir kullanıcının bir resim yüklediği ve bir sonuç beklediği bir web formu — tek bir barkod taraması için 250 ms gecikme kabul edilebilir olabilir. Arka plan belge işleme görevleri için, biriken gecikme iş akışının baskın maliyeti haline gelir.

IronBarcode'un yerel işlemleri, tipik donanımda barkod başına 10–50ms arasında çalışır. 10.000 barkodda, bu toplamda yaklaşık 8 dakika demektir ki,Cloudmersivemodeliyle yalnızca ağ yükü olarak 41 dakika olan süreyle karşılaştırıldığında.

Veri Egemenliği

HerCloudmersivebarkod işlemi verileri Cloudmersive'nin sunucularına iletir. Barkod okuma için, bu sizin resimlerinizin — potansiyel olarak hasta tanımlayıcıları, finansal hesap numaraları, gönderim adresleri, çalışan kimlikleri veya özel envanter verileri içeren — ağınızı terk etmesi anlamına gelir.

Uyum etkileri, düzenlemelere göre değişir:

Sağlık, savunma, finansal hizmetler veya hükümet iş yükleri için, Cloudmersive'ın bulut modeli genellikle herhangi bir özellik veya maliyet değerlendirmesi yapılmadan önce diskalifiye edilir. Veriler ağınızı terk eder — bu, diskalifiye eden gerçektir.

IronBarcode her şeyi yerel olarak işler. Barkod resimleri asla ana makineden çıkmaz. Hiçbir çeşit veri iletimi yoktur.

Güvenilirlik

Cloudmersive bir dış bağımlılıktır. Uygulamanızın barkod işlem güvenilirliği, Cloudmersive'nin çalışma süresi ile sınırlıdır.

using Cloudmersive.APIClient.NET.Barcode.Api;
using Cloudmersive.APIClient.NET.Barcode.Client;
using System;
using System.Threading;
using System.Threading.Tasks;

public class CloudmersiveBarcodeService
{
    private readonly BarcodeScanApi _scanApi;
    private static int _requestCount = 0;

    public CloudmersiveBarcodeService()
    {
        Configuration.Default.ApiKey.Add("Apikey", "YOUR-CLOUDMERSIVE-API-KEY");
        _scanApi = new BarcodeScanApi();
    }

    public async Task<string> ScanWithRetry(byte[] imageBytes, int maxRetries = 3)
    {
        for (int attempt = 1; attempt <= maxRetries; attempt++)
        {
            try
            {
                Interlocked.Increment(ref _requestCount);

                using var stream = new System.IO.MemoryStream(imageBytes);
                var result = await _scanApi.BarcodeScanImageAsync(stream);

                if (result.Successful == true)
                    return result.RawText;

                throw new InvalidOperationException("Scan unsuccessful");
            }
            catch (ApiException ex) when (ex.ErrorCode == 429)
            {
                if (attempt < maxRetries)
                    await Task.Delay(TimeSpan.FromSeconds(Math.Pow(2, attempt)));
                else
                    throw;
            }
            catch (Exception) when (attempt < maxRetries)
            {
                await Task.Delay(TimeSpan.FromMilliseconds(500 * attempt));
            }
        }
        throw new InvalidOperationException("All retry attempts failed");
    }
}

using Cloudmersive.APIClient.NET.Barcode.Api;
using Cloudmersive.APIClient.NET.Barcode.Client;
using System;
using System.Threading;
using System.Threading.Tasks;

public class CloudmersiveBarcodeService
{
    private readonly BarcodeScanApi _scanApi;
    private static int _requestCount = 0;

    public CloudmersiveBarcodeService()
    {
        Configuration.Default.ApiKey.Add("Apikey", "YOUR-CLOUDMERSIVE-API-KEY");
        _scanApi = new BarcodeScanApi();
    }

    public async Task<string> ScanWithRetry(byte[] imageBytes, int maxRetries = 3)
    {
        for (int attempt = 1; attempt <= maxRetries; attempt++)
        {
            try
            {
                Interlocked.Increment(ref _requestCount);

                using var stream = new System.IO.MemoryStream(imageBytes);
                var result = await _scanApi.BarcodeScanImageAsync(stream);

                if (result.Successful == true)
                    return result.RawText;

                throw new InvalidOperationException("Scan unsuccessful");
            }
            catch (ApiException ex) when (ex.ErrorCode == 429)
            {
                if (attempt < maxRetries)
                    await Task.Delay(TimeSpan.FromSeconds(Math.Pow(2, attempt)));
                else
                    throw;
            }
            catch (Exception) when (attempt < maxRetries)
            {
                await Task.Delay(TimeSpan.FromMilliseconds(500 * attempt));
            }
        }
        throw new InvalidOperationException("All retry attempts failed");
    }
}

Imports Cloudmersive.APIClient.NET.Barcode.Api
Imports Cloudmersive.APIClient.NET.Barcode.Client
Imports System
Imports System.Threading
Imports System.Threading.Tasks

Public Class CloudmersiveBarcodeService
    Private ReadOnly _scanApi As BarcodeScanApi
    Private Shared _requestCount As Integer = 0

    Public Sub New()
        Configuration.Default.ApiKey.Add("Apikey", "YOUR-CLOUDMERSIVE-API-KEY")
        _scanApi = New BarcodeScanApi()
    End Sub

    Public Async Function ScanWithRetry(imageBytes As Byte(), Optional maxRetries As Integer = 3) As Task(Of String)
        For attempt As Integer = 1 To maxRetries
            Try
                Interlocked.Increment(_requestCount)

                Using stream As New System.IO.MemoryStream(imageBytes)
                    Dim result = Await _scanApi.BarcodeScanImageAsync(stream)

                    If result.Successful = True Then
                        Return result.RawText
                    End If

                    Throw New InvalidOperationException("Scan unsuccessful")
                End Using
            Catch ex As ApiException When ex.ErrorCode = 429
                If attempt < maxRetries Then
                    Await Task.Delay(TimeSpan.FromSeconds(Math.Pow(2, attempt)))
                Else
                    Throw
                End If
            Catch ex As Exception When attempt < maxRetries
                Await Task.Delay(TimeSpan.FromMilliseconds(500 * attempt))
            End Try
        Next
        Throw New InvalidOperationException("All retry attempts failed")
    End Function
End Class

// NuGet: dotnet add package IronBarcode
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// Generate locally
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsPng("qr.png");

// Read locally
var result = BarcodeReader.Read("barcode.png").First();
Console.WriteLine(result.Value);

// NuGet: dotnet add package IronBarcode
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// Generate locally
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsPng("qr.png");

// Read locally
var result = BarcodeReader.Read("barcode.png").First();
Console.WriteLine(result.Value);

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

' Generate locally
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode) _
    .SaveAsPng("qr.png")

' Read locally
Dim result = BarcodeReader.Read("barcode.png").First()
Console.WriteLine(result.Value)

IronBarcode Anlama

IronBarcode, barkodları tamamen ana makinede işleyen yerel bir .NET kütüphanesidir. 50'den fazla barkod formatını okuyup oluşturur, PDF'leri doğal olarak işler ve .NET Framework 4.6.2'den .NET 9'a kadar her .NET platformunda çalışır.

Anahtar özellikler:

• Tamamen yerel işleme: Herhangi bir barkod işlemi sırasında ağ çağrısı yok
• İstek başına maliyet yoktur: Bir lisans, sınırsız barkod işlemlerini kapsar
• Hız sınırı yoktur: Donanımınızın desteklediği kadar barkod işleyin
• Çalışma zamanında dış bağımlılık yoktur: İnternet bağlantısı gerekmez
• Yerel PDF desteği: Resimleri ilk önce çıkarmadan PDF'lerden barkod okuyun
• Tam okuma ve yazma: Her büyük formatta barkod oluşturun, görüntülerden, PDF'lerden ve akışlardan okuyun

// NuGet: dotnet add package IronBarcode
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// QR code generation
QRCodeWriter.CreateQrCode("https://example.com", 500)
    .SaveAsPng("qr.png");

// QR code with brand logo
QRCodeWriter.CreateQrCode("https://example.com", 500)
    .AddBrandLogo("logo.png")
    .SaveAsPng("branded-qr.png");

// Code128 generation
BarcodeWriter.CreateBarcode("SHIP-2024031500428", BarcodeEncoding.Code128)
    .SaveAsPng("barcode.png");

// Get bytes for embedding in document or API response
byte[] bytes = BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .ToPngBinaryData();

// Read from image
var results = BarcodeReader.Read("barcode.png");
foreach (var r in results)
{
    Console.WriteLine($"{r.Format}: {r.Value}");
}

// Read from PDF — native, no image extraction step
var pdfResults = BarcodeReader.Read("invoices.pdf");
foreach (var r in pdfResults)
{
    Console.WriteLine($"Page {r.PageNumber}: {r.Value}");
}

// Multi-barcode detection
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
};
var multiResults = BarcodeReader.Read("manifest.png", options);

// NuGet: dotnet add package IronBarcode
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// QR code generation
QRCodeWriter.CreateQrCode("https://example.com", 500)
    .SaveAsPng("qr.png");

// QR code with brand logo
QRCodeWriter.CreateQrCode("https://example.com", 500)
    .AddBrandLogo("logo.png")
    .SaveAsPng("branded-qr.png");

// Code128 generation
BarcodeWriter.CreateBarcode("SHIP-2024031500428", BarcodeEncoding.Code128)
    .SaveAsPng("barcode.png");

// Get bytes for embedding in document or API response
byte[] bytes = BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .ToPngBinaryData();

// Read from image
var results = BarcodeReader.Read("barcode.png");
foreach (var r in results)
{
    Console.WriteLine($"{r.Format}: {r.Value}");
}

// Read from PDF — native, no image extraction step
var pdfResults = BarcodeReader.Read("invoices.pdf");
foreach (var r in pdfResults)
{
    Console.WriteLine($"Page {r.PageNumber}: {r.Value}");
}

// Multi-barcode detection
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
};
var multiResults = BarcodeReader.Read("manifest.png", options);

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

' QR code generation
QRCodeWriter.CreateQrCode("https://example.com", 500).SaveAsPng("qr.png")

' QR code with brand logo
QRCodeWriter.CreateQrCode("https://example.com", 500) _
    .AddBrandLogo("logo.png") _
    .SaveAsPng("branded-qr.png")

' Code128 generation
BarcodeWriter.CreateBarcode("SHIP-2024031500428", BarcodeEncoding.Code128) _
    .SaveAsPng("barcode.png")

' Get bytes for embedding in document or API response
Dim bytes As Byte() = BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128) _
    .ToPngBinaryData()

' Read from image
Dim results = BarcodeReader.Read("barcode.png")
For Each r In results
    Console.WriteLine($"{r.Format}: {r.Value}")
Next

' Read from PDF — native, no image extraction step
Dim pdfResults = BarcodeReader.Read("invoices.pdf")
For Each r In pdfResults
    Console.WriteLine($"Page {r.PageNumber}: {r.Value}")
Next

' Multi-barcode detection
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}
Dim multiResults = BarcodeReader.Read("manifest.png", options)

Özellik Karşılaştırması

API Eşleme Başvurusu

Takımlar Geçiş Yaptığında

Cloudmersive'den IronBarcode'ye geçiş tetikleyici neredeyse her zaman dört durumdan biridir:

Uygunluk gereksinimi: Bir güvenlik incelemesi, bir müşteri sözleşmesi veya bir düzenleyici denetim, hassas veri içeren barkod görüntülerinin ağdan çıktığını saptar. HIPAA, GDPR veya ITAR uygunluğu yerel işlemi gerektirir.Cloudmersiveentegrasyonu, maliyet veya kolaylığa bakılmaksızın değiştirilmelidir.

Maliyet sürprizi: Proje, Cloudmersive'in ücretsiz veya düşük maliyetli kademelerinin kullanımı karşıladığı düşük hacimle başlar. Uygulama daha fazla kullanıcı kazandıkça veya belge işleme hattı büyüdükçe, aylık fatura orantılı olarak büyür. Bir noktada — genellikle aylık $100–$200 — ekip, IronBarcode'nin süresiz lisansına karşı denklik matematiğini yapar ve geçiş yapmaya karar verir.

İzole ortam: Uygulama, internet erişimi olmayan bir ortamda çalışmak zorundadır — ağ kısıtlamaları olan bir fabrika sahası, hükümet tesisi veya sağlık tesisi.Cloudmersivebu ortamlarda mümkün değil.IronBarcode ağ bağlantısı olmadan çalışır.

Sözleşme Gecikmesi: Bir hizmet seviyesi anlaşması,Cloudmersiveağ giderinin garanti edilemeyeceği yanıt süreleri gerektirir. Yerel işleme ile IronBarcode, barkod işlemlerini SLA kapsamına alır.

using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
};

string[] invoicePaths = Directory.GetFiles("invoices", "*.pdf");

foreach (var invoicePath in invoicePaths)
{
    // One call per invoice processes all pages and all barcodes
    var barcodes = BarcodeReader.Read(invoicePath, options);

    foreach (var barcode in barcodes)
    {
        Console.WriteLine($"Invoice: {invoicePath} | Page: {barcode.PageNumber} | {barcode.Format}: {barcode.Value}");
    }
}

using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
};

string[] invoicePaths = Directory.GetFiles("invoices", "*.pdf");

foreach (var invoicePath in invoicePaths)
{
    // One call per invoice processes all pages and all barcodes
    var barcodes = BarcodeReader.Read(invoicePath, options);

    foreach (var barcode in barcodes)
    {
        Console.WriteLine($"Invoice: {invoicePath} | Page: {barcode.PageNumber} | {barcode.Format}: {barcode.Value}");
    }
}

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}

Dim invoicePaths As String() = Directory.GetFiles("invoices", "*.pdf")

For Each invoicePath In invoicePaths
    ' One call per invoice processes all pages and all barcodes
    Dim barcodes = BarcodeReader.Read(invoicePath, options)

    For Each barcode In barcodes
        Console.WriteLine($"Invoice: {invoicePath} | Page: {barcode.PageNumber} | {barcode.Format}: {barcode.Value}")
    Next
Next

Sonuç

Cloudmersive Barkod API'si bir bulut REST hizmetidir. Fiyatlandırması kullanımla birlikte ölçeklenir. Gecikmesi internete bağlıdır. KullanılabilirliğiCloudmersivealtyapısına bağlıdır. Verileriniz her barkod işleminde harici sunuculara ulaşır.

Bunlar bulut API modelinin yapısal özellikleridir,Cloudmersivehakkında şikayetler değil. Model, bu özelliklerin önem taşımadığı düşük hacimli prototip veya uygulamalar için iyi çalışır. Hacim arttıkça ve gereksinimler sıkılaştıkça pahalı, yavaş ve potansiyel olarak uyumsuz hale gelir.

IronBarcode'nin tek seferlik lisansı $749, sınırsız barkod işlemlerini kapsar, yerel olarak çalışır ve veri aktarımı olmadan PDF'leri doğal olarak işler, üretimCloudmersiveentegrasyonlarının gerektirdiği yeniden deneme altyapısının hiçbirini gerektirmez. Günde 10.000 barkodda, matematik ilk iki ay içinde IronBarcode lehine sonuçlanır.