Cloudmersive Barcode API vs IronBarcode: Porównanie bibliotek kodów kreskowych C#

Zrozumienie interfejsu API Cloudmersive BarCode

Cloudmersive oferuje zbiór interfejsów API REST obejmujących konwersję dokumentów, OCR, przetwarzanie obrazów i operacje związane z kodami BARCODE. Funkcjonalność BARCODE stanowi część szerszego portfolio API. Dla programistów .NET firma Cloudmersive udostępnia pakiet kliencki NuGet, który obsługuje ich punkty końcowe REST:

// Cloudmersive: HTTP client, per-request billing, data leaves your network
using Cloudmersive.APIClient.NETCore.Barcode.Api;
using Cloudmersive.APIClient.NETCore.Barcode.Client;

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

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

// Cloudmersive: HTTP client, per-request billing, data leaves your network
using Cloudmersive.APIClient.NETCore.Barcode.Api;
using Cloudmersive.APIClient.NETCore.Barcode.Client;

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

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

Imports Cloudmersive.APIClient.NETCore.Barcode.Api
Imports Cloudmersive.APIClient.NETCore.Barcode.Client

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

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

Ważną rzeczą, którą należy zrozumieć w odniesieniu do tego kodu, jest to, co faktycznie robi: wysyła żądanie HTTPS do infrastruktury Cloudmersive, czeka na odpowiedź i zwraca wynik. Każda linia kodu w integracji Cloudmersive jest zgodna z tym wzorcem. Nie ma przetwarzania lokalnego. Nie ma ścieżki offline. Każda operacja wymaga aktywnego połączenia internetowego i dostępnego serwera Cloudmersive.

Koszt w skali

Cloudmersive stosuje cennik oparty na liczbie zleceń. Dokładny koszt jednego żądania zależy od poziomu subskrypcji, ale podstawowy model jest taki sam na każdym poziomie: każda operacja związana z kodem kreskowym zużywa jedno żądanie z miesięcznego limitu.

Obliczenia przy typowych wielkościach produkcji:

Licencja wieczysta IronBarcode w cenie 749 USD (wersja Lite, dla jednego programisty) obejmuje nieograniczoną liczbę operacji związanych z kodami kreskowymi. Nie ma opłaty za każde zlecenie, niezależnie od jego wielkości. Zespół przetwarzający 10 000 kodów kreskowych dziennie zwraca koszt licencji w mniej niż dziesięć dni w porównaniu z kwotą, jaką zapłaciłby Cloudmersive rocznie.

W przypadku zespołu składającego się z 3 programistów licencja Plus za jednorazową opłatą w wysokości 1499 USD jest porównywalna z opcją za 3650 USD rocznie przy 10 000 BarCodes dziennie. Licencja IronBarcode zwraca się w ciągu pięciu miesięcy dzięki oszczędnościom w Cloudmersive.

Wpływ opóźnień

Każda operacja związana z kodami barcode w Cloudmersive obejmuje:

1. Serializacja żądania (bajty obrazu lub dane BARCODE)
2. Nawiązywanie lub ponowne wykorzystanie połączenia HTTPS
3. Przesyłanie danych na serwery Cloudmersive
4. Oczekiwanie na przetworzenie po stronie serwera
5. Otrzymanie odpowiedzi
6. Deserializacja wyniku

Zmierzony czas opóźnienia dla operacji związanych z kodami BARCODE w Cloudmersive wynosi zazwyczaj 100–500 ms na wywołanie, w zależności od obciążenia serwera, odległości geograficznej i rozmiaru obrazu. Przy 250 ms na wywołanie:

W przypadku punktów końcowych przeznaczonych dla użytkowników — formularza internetowego, w którym użytkownik przesyła obraz i oczekuje wyniku — opóźnienie wynoszące 250 ms przy skanowaniu pojedynczego BARCODE-a może być akceptowalne. W przypadku zadań przetwarzania dokumentów w tle dominującym kosztem przepływu pracy staje się skumulowane opóźnienie.

Lokalne przetwarzanie w IronBarcode trwa 10–50 ms na BarCode na typowym sprzęcie. Przy 10 000 BarCode'ów daje to łącznie około 8 minut w porównaniu z 41 minutami samego obciążenia sieciowego w modelu Cloudmersive.

Suwerenność danych

Każda operacja związana z kodami BARCODE w Cloudmersive powoduje przesłanie danych do serwerów Cloudmersive. W przypadku odczytu BarCode oznacza to, że Państwa obrazy — potencjalnie zawierające identyfikatory pacjentów, numery kont finansowych, adresy wysyłkowe, identyfikatory pracowników lub zastrzeżone dane dotyczące zapasów — opuszczają Państwa sieć.

Konsekwencje w zakresie zgodności z przepisami zależą od otoczenia regulacyjnego:

W przypadku zadań związanych z opieką zdrowotną, obronnością, usługami finansowymi lub administracją publiczną model chmury Cloudmersive często dyskwalifikuje tę platformę jeszcze przed oceną funkcji lub kosztów. Dane opuszczają Twoją sieć — to właśnie ten fakt dyskwalifikuje tę platformę.

IronBarcode przetwarza wszystko lokalnie. Obrazy BarCode nigdy nie opuszczają komputera hosta. Nie ma żadnej transmisji danych.

Wiarygodność

Cloudmersive jest zależnością zewnętrzną. Niezawodność przetwarzania BarCodes w Twojej aplikacji zależy od czasu działania platformy Cloudmersive.

// Production Cloudmersive code requires significant infrastructure
using Cloudmersive.APIClient.NETCore.Barcode.Api;
using Cloudmersive.APIClient.NETCore.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
            {
                // Track quota consumption
                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)
            {
                // Rate limited — exponential backoff
                if (attempt < maxRetries)
                    await Task.Delay(TimeSpan.FromSeconds(Math.Pow(2, attempt)));
                else
                    throw;
            }
            catch (Exception) when (attempt < maxRetries)
            {
                // Network error — retry
                await Task.Delay(TimeSpan.FromMilliseconds(500 * attempt));
            }
        }
        throw new InvalidOperationException("All retry attempts failed");
    }
}

// Production Cloudmersive code requires significant infrastructure
using Cloudmersive.APIClient.NETCore.Barcode.Api;
using Cloudmersive.APIClient.NETCore.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
            {
                // Track quota consumption
                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)
            {
                // Rate limited — exponential backoff
                if (attempt < maxRetries)
                    await Task.Delay(TimeSpan.FromSeconds(Math.Pow(2, attempt)));
                else
                    throw;
            }
            catch (Exception) when (attempt < maxRetries)
            {
                // Network error — retry
                await Task.Delay(TimeSpan.FromMilliseconds(500 * attempt));
            }
        }
        throw new InvalidOperationException("All retry attempts failed");
    }
}

Imports Cloudmersive.APIClient.NETCore.Barcode.Api
Imports Cloudmersive.APIClient.NETCore.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
                ' Track quota consumption
                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
                ' Rate limited — exponential backoff
                If attempt < maxRetries Then
                    Await Task.Delay(TimeSpan.FromSeconds(Math.Pow(2, attempt)))
                Else
                    Throw
                End If
            Catch ex As Exception When attempt < maxRetries
                ' Network error — retry
                Await Task.Delay(TimeSpan.FromMilliseconds(500 * attempt))
            End Try
        Next
        Throw New InvalidOperationException("All retry attempts failed")
    End Function
End Class

// IronBarcode: local, instant, no cost per call
// NuGet: dotnet add package IronBarcode
using IronBarCode;

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

// Generate — no network call
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsPng("qr.png");

// Read — no network call
var result = BarcodeReader.Read("barcode.png").First();
Console.WriteLine(result.Value);

// IronBarcode: local, instant, no cost per call
// NuGet: dotnet add package IronBarcode
using IronBarCode;

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

// Generate — no network call
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsPng("qr.png");

// Read — no network call
var result = BarcodeReader.Read("barcode.png").First();
Console.WriteLine(result.Value);

Imports IronBarCode

' IronBarcode: local, instant, no cost per call
' NuGet: dotnet add package IronBarcode

IronBarCode.License.LicenseKey = "YOUR-KEY"

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

' Read — no network call
Dim result = BarcodeReader.Read("barcode.png").First()
Console.WriteLine(result.Value)

Zrozumienie IronBarcode

IronBarcode to natywna biblioteka .NET, która przetwarza kody kreskowe całkowicie na komputerze hosta. Obsługuje odczyt i generowanie ponad 50 formatów kodów kreskowych, natywnie przetwarza pliki PDF i działa na każdej platformie .NET od .NET Framework 4.6.2 do .NET 9.

Kluczowe cechy:

• W pełni lokalne przetwarzanie: brak połączeń sieciowych podczas jakiejkolwiek operacji związanej z BarCode
• Brak kosztów za każde żądanie: jedna licencja obejmuje nieograniczoną liczbę operacji związanych z BarCode
• Brak limitów szybkości: przetwarzaj tyle BarCode'ów, ile obsługuje Twój sprzęt
• Brak zewnętrznych zależności w czasie wykonywania: nie jest wymagańe połączenie z Internetem
• Natywna obsługa plików PDF: odczytuj BarCODE-y z plików PDF bez konieczności uprzedniego wyodrębniania obrazów
• Pełny odczyt i zapis: Generowanie BARCODE-ów we wszystkich głównych formatach, odczyt z obrazów, plików PDF i strumieni

// NuGet: dotnet add package IronBarcode
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-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-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-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)

Porównanie funkcji

Przewodnik po mapowaniu API

Kiedy zespoły się zmieniają

Powodem przejścia z Cloudmersive na IronBarcode jest prawie zawsze jedna z czterech sytuacji:

Wymóg zgodności: Kontrola bezpieczeństwa, umowa z klientem lub audyt regulacyjny wykazały, że obrazy BARCODE-ów zawierających dane wrażliwe opuszczają sieć. Zgodność z HIPAA, RODO lub ITAR wymaga przetwarzania lokalnego. Integracja z Cloudmersive musi zostać zastąpiona bez względu na koszty i wygodę.

Niespodzianka kosztowa przy większej skali: Projekt rozpoczyna się od niewielkiego wolumenu, gdzie bezpłatne lub niedrogie poziomy Cloudmersive pokrywają koszty użytkowania. Wraz ze wzrostem liczby użytkowników aplikacji lub rozbudową procesu przetwarzania dokumentów, miesięczny rachunek rośnie proporcjonalnie. W pewnym momencie — zazwyczaj przy kosztach rzędu 100–200 USD miesięcznie — zespół dokonuje kalkulacji progu rentowności w porównaniu z Licencją wieczystą IronBarcode i decyduje się na migrację.

Środowisko typu odizolowane: Aplikacja musi działać w środowisku bez dostępu do Internetu — na hali fabrycznej, w obiekcie rządowym, w placówce opieki zdrowotnej z ograniczeniami sieciowymi. Cloudmersive nie działa w tych środowiskach. IronBarcode działa bez połączenia z siecią.

Opóźnienie w umowie SLA: Umowa o gwarantowanym poziomie usług wymaga czasów odpowiedzi, których nie da się zagwarantować ze względu na obciążenie sieci Cloudmersive. Lokalne przetwarzanie za pomocą IronBarcode sprawia, że operacje związane z kodami kreskowymi mieszczą się w ramach umowy SLA.

using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-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-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-KEY"

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

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

For Each invoicePath As String 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

Wnioski

Cloudmersive BarCode API to usługa REST w chmurze. Jej cena zależy od tego, jak często z niej korzystasz. Jego opóźnienie zależy od internetu. Jego dostępność zależy od infrastruktury Cloudmersive. Twoje dane są przesyłane na serwery zewnętrzne przy każdej operacji związanej z BarCode.

Są to właściwości strukturalne modelu API w chmurze, a nie konkretne zarzuty wobec Cloudmersive. Model sprawdza się dobrze w przypadku prototypowania na małą skalę lub aplikacji, w których żadna z tych właściwości nie ma znaczenia. Wraz ze wzrostem wolumenu i zaostrzeniem wymagań staje się to kosztowne, powolne i potencjalnie niezgodne z przepisami.

Jednorazowa licencja IronBarcode w cenie 749 USD obejmuje nieograniczoną liczbę operacji związanych z kodami kreskowymi, działa lokalnie bez transmisji danych, przetwarza pliki PDF natywnie i nie wymaga żadnej infrastruktury ponownych prób, jakiej wymagają integracje Cloudmersive w środowisku produkcyjnym. Przy 10 000 BARCODE-ów dziennie, już w ciągu pierwszych dwóch tygodni IronBarcode wychodzi na plus.