Comprendre l'API de code-barres Cloudmersive

Cloudmersive propose une collection d'API REST couvrant la conversion de documents, la reconnaissance optique de caractères (OCR), le traitement d'images et les opérations sur les codes-barres. La fonctionnalité de code-barres ne représente qu'une partie d'un portefeuille d'API plus vaste. Pour les développeurs .NET , Cloudmersivefournit un package client NuGet qui encapsule leurs points de terminaison REST :

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

L'important à comprendre concernant ce code, c'est ce qu'il fait réellement : il envoie une requête HTTPS à l'infrastructure de Cloudmersive, attend une réponse et renvoie le résultat. Chaque ligne de traitement des codes-barres dans une intégration Cloudmersivesuit ce modèle. Il n'y a pas de traitement local. Il n'existe pas de voie hors ligne. Chaque opération nécessite une connexion internet active et un serveur Cloudmersivedisponible.

Coût à l'échelle

Cloudmersive utilise une tarification par requête. Le coût exact par requête dépend de votre niveau d'abonnement, mais le modèle de base reste le même à tous les niveaux : chaque opération de code-barres consomme une requête de votre quota mensuel.

Les calculs aux volumes de production courants, mappés sur les niveaux publiés de Cloudmersive:

La licence perpétuelle Code-barres IronBarcode à 749 $ (Lite, développeur unique) couvre un nombre illimité d'opérations de codes-barres. Il n'y a pas de frais par requête, quel que soit le volume. Une équipe traitant 10 000 codes-barres par jour s'équilibre sur le coût de la licence dans les six premières semaines de ce qu'elle paierait Cloudmersiveannuellement.

Pour une équipe de 3 développeurs, la licence Plus à 1 499 $ en une seule fois se compare à environ 6 000 $ par an à 10 000 codes-barres par jour. La licence Code-barres IronBarcode s'amortit en trois mois d'économies Cloudmersive.

Impact de la latence

Chaque opération de lecture de code-barres Cloudmersiveimplique :

1. Sérialisation de la requête (octets d'image ou données de code-barres)
2. Établir ou réutiliser une connexion HTTPS
3. Transmission des données aux serveurs Cloudmersive
4. Attente du traitement côté serveur
5. Réception de la réponse
6. Désérialisation du résultat

Les directives publiées par Cloudmersiveet les rapports des clients placent la latence par appel à environ 150–400ms, selon la charge du serveur, la proximité géographique, et la taille de l'image. À 250ms par appel :

Pour les points de terminaison destinés aux utilisateurs — un formulaire Web où un utilisateur télécharge une image et attend un résultat — une latence de 250 ms sur une seule lecture de code-barres peut être acceptable. Pour les tâches de traitement de documents en arrière-plan, la latence accumulée devient le coût dominant du flux de travail.

Le traitement local d'IronBarcode s'effectue en 10 à 50 ms par code-barres sur un matériel standard. Avec 10 000 codes-barres, cela représente environ 8 minutes au total, contre 41 minutes de surcharge réseau uniquement dans le modèle Cloudmersive.

Souveraineté des données

Chaque opération de lecture de code-barres Cloudmersivetransmet des données aux serveurs de Cloudmersive. Pour la lecture des codes-barres, cela signifie que vos images — pouvant contenir des identifiants de patients, des numéros de comptes financiers, des adresses de livraison, des identifiants d'employés ou des données d'inventaire confidentielles — quittent votre réseau.

Les implications en matière de conformité dépendent de votre environnement réglementaire :

Pour les charges de travail liées à la santé, la défense, les services financiers ou le gouvernement, le modèle cloud de Cloudmersiveest souvent un obstacle majeur avant même toute évaluation des fonctionnalités ou du coût. Le fait que les données quittent votre réseau est rédhibitoire.

IronBarcode traite tout en local. Les images des codes-barres ne quittent jamais la machine hôte. Aucune donnée n'est transmise.

Fiabilité

Cloudmersive est une dépendance externe. La fiabilité du traitement des codes-barres de votre application est limitée par la disponibilité de Cloudmersive.

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)

Comprendre IronBarcode

IronBarcode est une bibliothèque .NET native qui traite les codes-barres entièrement sur la machine hôte. Elle prend en charge la lecture et la génération de plus de 50 formats de codes-barres, traite nativement les fichiers PDF et fonctionne sur toutes les plateformes .NET , de .NET Framework 4.6.2 à .NET 9.

Caractéristiques principales :

• Traitement entièrement local : aucun appel réseau lors de l'opération de lecture de codes-barres
• Aucun coût par requête : une seule licence couvre un nombre illimité d'opérations de codes-barres
• Aucune limite de débit : Traitez autant de codes-barres que votre matériel le permet.
• Aucune dépendance externe à l'exécution : aucune connexion Internet requise
• Prise en charge native des PDF : lecture des codes-barres directement dans les PDF, sans extraction préalable des images.
• Lecture et écriture complètes : Générez des codes-barres dans tous les principaux formats, lisez des images, des PDF et des flux de données.

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

Comparaison des fonctionnalités

Référence de mappage d'API

Quand les équipes changent

Le déclencheur du passage de Cloudmersiveà Code-barres IronBarcode est presque toujours l'une des quatre situations suivantes :

Exigence de conformité : Un examen de sécurité, un contrat client ou un audit réglementaire révèle que des images de codes-barres contenant des données sensibles quittent le réseau. La conformité aux normes HIPAA, RGPD ou ITAR exige un traitement local. L'intégration Cloudmersivedoit être remplacée, quels que soient son coût ou sa praticité.

Coûts imprévus à grande échelle : le projet démarre avec un faible volume d'utilisation couvert par les offres gratuites ou à faible coût de Cloudmersive. À mesure que l'application gagne des utilisateurs ou que le flux de traitement des documents s'accroît, la facture mensuelle augmente proportionnellement. À un certain moment (généralement entre 100 et 200 dollars par mois), l'équipe effectue le calcul du seuil de rentabilité par rapport à la licence perpétuelle d'IronBarcode et décide de migrer.

Environnement isolé : L'application doit fonctionner dans un environnement sans accès à Internet — une usine, une installation gouvernementale, un établissement de santé avec des restrictions de réseau. Cloudmersiveest impossible dans ces environnements. Code-barres IronBarcode fonctionne sans aucune connexion réseau.

Latence dans un SLA : Un accord de niveau de service exige des temps de réponse que la surcharge réseau de Cloudmersiverend impossible à garantir. Le traitement local avec Code-barres IronBarcode permet de réaliser les opérations de codes-barres dans les limites du SLA.

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

Conclusion

L'API CloudmersiveBarcode est un service REST cloud. Son prix est proportionnel à votre utilisation. Sa latence est déterminée par Internet. Sa disponibilité dépend de l'infrastructure de Cloudmersive. Vos données sont transmises à des serveurs externes à chaque opération de lecture de code-barres.

Ce sont des propriétés structurelles du modèle d'API cloud, et non des critiques spécifiques à Cloudmersive. Ce modèle convient parfaitement au prototypage en petite série ou aux applications où aucune de ces propriétés n'a d'importance. Cela devient coûteux, lent et potentiellement non conforme à mesure que le volume augmente et que les exigences se durcissent.

La licence unique d'IronBarcode à 749 $ couvre un nombre illimité d'opérations de codes-barres, fonctionne localement sans transmission de données, traite les PDF nativement et ne nécessite aucune infrastructure de nouvelle tentative comme le requièrent les intégrations Cloudmersiveen production. À 10 000 codes-barres par jour, les mathématiques se résolvent en faveur d'IronBarcode dans les deux premiers mois.