CloudmersiveバーコードAPIの理解

Cloudmersiveは、文書変換、OCR、画像処理、バーコード処理を網羅するREST API群を提供しています。 バーコード機能は、より広範なAPIポートフォリオの一部です。 .NET開発者向けに、CloudmersiveはRESTエンドポイントをラップするNuGetクライアントパッケージを提供しています。

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

このコードについて理解しておくべき重要な点は、実際に何をしているのかということです。つまり、CloudmersiveのインフラストラクチャにHTTPSリクエストを送信し、応答を待ち、結果を返します。 Cloudmersive統合におけるバーコード関連の作業はすべて、このパターンに従います。 ローカル処理は行われません。 オフラインパスはありません。 すべての操作は、有効なインターネット接続と利用可能なCloudmersiveサーバーに依存します。

規模の経済によるコスト

Cloudmersiveはリクエストごとの料金体系を採用しています。 リクエストごとの正確なコストは契約プランによって異なりますが、基本的な仕組みはどのプランでも同じです。バーコード操作を行うたびに、月間割り当て量から1リクエストが消費されます。

一般的な生産量での数式は、Cloudmersiveの公開された階層にマップされます：

IronBarcodeの永久ライセンス（Lite、シングル開発者向け、749ドル）では、無制限のバーコード操作が可能です。 リクエスト量に関わらず、リクエストごとの料金は一切かかりません。 1日1万のバーコードを処理するチームは、最初の6週間で年間Cloudmersiveに支払う費用とライセンスコストが相殺されます。

3人の開発者チームで、1回限りのライセンス($1,499)は、1日1万のバーコードで年間およそ$6,000に対抗します。 IronBarcodeのライセンスは3ヶ月のCloudmersive節約で元が取れます。

遅延の影響

Cloudmersiveの各バーコード操作には以下が含まれます。

1. リクエスト（画像バイトまたはバーコードデータ）のシリアル化
2. HTTPS接続の確立または再利用
3. データをCloudmersiveサーバーに送信する
4. サーバー側の処理を待機中
5. 回答を受け取る
6. 結果を逆シリアル化する

Cloudmersiveの公開ガイダンスと顧客レポートによれば、サーバーの負荷、地理的近接性、画像サイズに応じて、1回の呼び出しでおよそ150〜400msの遅延があります。呼び出し1回あたり250msの場合：

ユーザー向けのエンドポイント（ユーザーが画像をアップロードして結果を期待するWebフォームなど）の場合、単一のバーコードスキャンにおける250ミリ秒の遅延は許容範囲内となる可能性がある。 バックグラウンドで行われる文書処理ジョブの場合、蓄積された遅延がワークフローの主要なコストとなる。

IronBarcodeのローカル処理は、一般的なハードウェアではバーコード1つあたり10～50ミリ秒で完了します。 10,000個のバーコードの場合、処理時間は合計で約8分ですが、Cloudmersiveモデルではネットワークオーバーヘッドだけで41分かかります。

データ主権

Cloudmersiveのバーコード処理はすべて、データをCloudmersiveのサーバーに送信します。 バーコード読み取りの場合、患者識別情報、金融機関の口座番号、配送先住所、従業員ID、または独自の在庫データなどが含まれている可能性のある画像が、ネットワーク外に送信されることになります。

法令遵守上の影響は、規制環境によって異なります。

医療、防衛、金融サービス、政府機関などのワークロードにおいては、Cloudmersiveのクラウドモデルは、機能やコストを評価する前に、多くの場合、不適格と判断されます。データが自社ネットワークから外部へ送信されるという点が、不適格となる決定的な要因です。

IronBarcodeはすべての処理をローカルで行います。 バーコード画像はホストマシンから外部に送信されることはありません。いかなる種類のデータ送信も行われません。

信頼性

Cloudmersiveは外部依存関係です。 アプリケーションのバーコード処理の信頼性は、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)

IronBarcodeを理解する

IronBarcodeは、ホストマシン上でバーコードを完全に処理するネイティブ.NETライブラリです。50種類以上のバーコード形式の読み取りと生成をサポートし、PDFをネイティブに処理します。また、 .NET Framework 4.6.2から.NET 9までのすべて for .NETプラットフォームで動作します。

主な特徴：

-完全ローカル処理：バーコード操作中にネットワーク呼び出しは一切発生しません -リクエストごとの費用は不要： 1つのライセンスで無制限のバーコード操作が可能 -処理速度制限なし：ハードウェアがサポートする限り、バーコードをいくつでも処理できます。 -実行時に外部依存関係なし：インターネット接続不要 -ネイティブPDFサポート：画像を抽出せずにPDFからバーコードを読み取ります -完全な読み書き機能：主要なすべてのフォーマットでバーコードを生成し、画像、PDF、ストリームから読み取ります。

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

機能比較

APIマッピングリファレンス

チームが切り替わるとき

CloudmersiveからIronBarcodeへの切り替えのきっかけとなるのは、ほぼ常に以下の4つの状況のいずれかです。

コンプライアンス要件：セキュリティレビュー、顧客契約、または規制監査により、機密データを含むバーコード画像がネットワークから外部に送信されていることが確認される。 HIPAA、GDPR、またはITARへの準拠には、現地での処理が必要です。 Cloudmersiveとの連携は、コストや利便性に関係なく、必ず置き換える必要がある。

規模拡大に伴うコストの予期せぬ増加：プロジェクトは少量から開始され、Cloudmersiveの無料または低価格プランで利用量がカバーされます。 アプリケーションのユーザー数が増加したり、文書処理パイプラインが拡大したりすると、月額料金もそれに比例して増加します。 ある時点（通常は月額100ドルから200ドル程度）で、チームはIronBarcodeの永久ライセンスと比較して損益分岐点を計算し、移行を決定する。

エアギャップ環境：アプリケーションは、インターネットにアクセスできない環境（工場、政府機関、ネットワーク制限のある医療施設など）で実行する必要があります。 これらの環境では、クラウドマーシブは不可能です。 IronBarcodeはネットワーク接続なしで動作します。

SLAにおける遅延：サービスレベル契約では応答時間が求められますが、Cloudmersiveのネットワークオーバーヘッドのため、それを保証することは不可能です。 IronBarcodeによるローカル処理により、バーコード処理を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

結論

Cloudmersive Barcode APIはクラウドベースのRESTサービスです。料金は使用量に応じて変動します。 その遅延時間はインターネットによって決まります。 その利用可能性は、Cloudmersiveのインフラストラクチャに依存します。 お客様のデータは、バーコード処理のたびに外部サーバーに送信されます。

これらはクラウドAPIモデルの構造的な特性であり、Cloudmersiveに対する具体的な不満ではありません。 このモデルは、少量生産のプロトタイプ作成や、これらの特性が全く重要でない用途には問題なく機能します。 処理量が増加し、要件が厳しくなるにつれて、コストがかさみ、処理速度が遅くなり、場合によっては法令遵守違反となる可能性が高くなります。

IronBarcodeの749ドルの1回限りのライセンスは、無制限のバーコード操作をカバーし、データ送信なしでローカルで実行され、PDFをネイティブに処理し、本番環境のCloudmersive統合で必要とされる再試行インフラストラクチャを一切必要としません。 日次1万のバーコードで、数式は最初の2ヶ月でIronBarcodeの方に解決されます。