Curl DotNet: Curl 슈퍼파워를 .NET 런타임에 가져오기

주요 특징

• 제로 번역: curl HTTPS 명령어를 C# 소스에 직접 붙여넣습니다.

• 크로스 플랫폼: Windows, Linux, MacOS 및 기타를 완벽하게 지원합니다.

• 타입 안전성: 의존성 주입 시나리오에 대해 유연한 빌더를 사용할 수 있는 옵션이 있습니다.

• 관측 가능성: 구조화된 이벤트를 기록하기 위한 내장 지원.

문자열 API: 붙여넣기 및 실행 curl 명령

이 방법은 상태 확인, 지원 에이전트 또는 빠른 프로토타입에 적합합니다. curl 명령을 문자열로 전달하기만 하면 됩니다.

using CurlDotNet;

// Simply paste the command string
var response = await Curl.ExecuteAsync("curl https://api.github.com/users/octocat");

// Access the data
Console.WriteLine(response.Body);

using CurlDotNet;

// Simply paste the command string
var response = await Curl.ExecuteAsync("curl https://api.github.com/users/octocat");

// Access the data
Console.WriteLine(response.Body);

환경 변수와 함께 유연한 빌더 사용하기

환경 변수를 통해 민감한 데이터를 처리해야 하거나 깔끔한 아키텍처를 요구하는 프로덕션 애플리케이션의 경우 유연한 빌더가 이상적입니다. 헤더의 문자열 이름을 지정하거나 파일 경로를 명시적으로 설정할 수 있습니다.

var response = await Curl.GetAsync("https://api.example.com/data")
    .WithHeader("Authorization", "Bearer " + Environment.GetEnvironmentVariable("API_KEY"))
    .WithTimeout(TimeSpan.FromSeconds(30))
    .ExecuteAsync();

var response = await Curl.GetAsync("https://api.example.com/data")
    .WithHeader("Authorization", "Bearer " + Environment.GetEnvironmentVariable("API_KEY"))
    .WithTimeout(TimeSpan.FromSeconds(30))
    .ExecuteAsync();

예제 1: IronPDF로 안전한 PDF 다운로드 및 편집

IronPDF는 .NET에서 픽셀 완벽한 PDF를 생성하기 위한 업계 표준입니다. 현대 웹 표준에 어려움을 겪는 다른 라이브러리와 달리, IronPDF는 HTML, CSS, 및 JavaScript를 Chrome 브라우저처럼 정확하게 렌더링합니다. 전체 솔루션으로 구축되어 있습니다: HTML 문자열이나 파일로부터 새 문서를 생성하고, 기존 PDF를 편집하거나, 문서를 병합하고, 워터마킹 및 암호화와 같은 보안 기능을 적용할 수 있는데, 서버에 외부 종속성이나 Adobe Acrobat을 설치할 필요가 없습니다.

복잡한 curl 플래그(SSL 오류 무시 또는 특정 헤더 순열과 같은)를 요구하는 레거시 내부 시스템에서 생성된 송장을 다운로드한 후 IronPDF를 사용하여 워터마크를 넣어야 한다고 상상해 보십시오.

HttpClient로 그 요청을 변환하는 데에 디버깅 시간이 몇 시간이 걸릴 수 있습니다. 하지만 CurlDotNet을 사용하면 명령을 붙여넣어 바이트를 얻고 IronPDF에 넘기기만 하면 됩니다.

using CurlDotNet;
using IronPdf;

// 1. Use CurlDotNet to handle the complex transport
// We use -k to allow insecure SSL (common in legacy internal apps)
var curlCommand = "curl -k https://internal-billing.local/invoice/1234 -H 'X-Dept: Sales'";
var response = await Curl.ExecuteAsync(curlCommand);

if (response.IsSuccess)
{
    // 2. Pass the raw bytes directly to IronPDF
    // IronPDF renders the PDF from the downloaded data
    var pdfDocument = PdfDocument.FromPdf(response.BodyBytes);

    // 3. Apply a watermark and save
    pdfDocument.ApplyWatermark("CONFIDENTIAL", 30, VerticalAlignment.Middle, HorizontalAlignment.Center);
    pdfDocument.SaveAs("Processed_Invoice.pdf");

    Console.WriteLine("Invoice downloaded and secured via IronPDF.");
}

using CurlDotNet;
using IronPdf;

// 1. Use CurlDotNet to handle the complex transport
// We use -k to allow insecure SSL (common in legacy internal apps)
var curlCommand = "curl -k https://internal-billing.local/invoice/1234 -H 'X-Dept: Sales'";
var response = await Curl.ExecuteAsync(curlCommand);

if (response.IsSuccess)
{
    // 2. Pass the raw bytes directly to IronPDF
    // IronPDF renders the PDF from the downloaded data
    var pdfDocument = PdfDocument.FromPdf(response.BodyBytes);

    // 3. Apply a watermark and save
    pdfDocument.ApplyWatermark("CONFIDENTIAL", 30, VerticalAlignment.Middle, HorizontalAlignment.Center);
    pdfDocument.SaveAs("Processed_Invoice.pdf");

    Console.WriteLine("Invoice downloaded and secured via IronPDF.");
}

콘솔 확인

PDF 출력

예제 2: IronOCR로 데이터 스크래핑 및 OCR

IronOCR는 Tesseract 5 엔진을 기반으로 하며, C# 및 .NET에 특화된 고급 광학 문자 인식 라이브러리입니다. 127개 이상의 언어를 지원하며, 낮은 해상도 스캔, 회전된 이미지, 또는 소음을 가진 배경과 같은 불완전한 소스에서 텍스트를 읽는 데 탁월합니다. "컴퓨터 비전" 기능 덕분에 텍스트 영역을 자동으로 감지할 수 있으며, 데이터를 단순한 문자열 뿐만 아니라 심층 분석을 위한 구조화된 콘텐츠(바코드, 문단, 줄, 문자)로 출력할 수 있습니다.

가끔 서버에 호스팅된 이미지에서 데이터를 추출해야 하는데, 이는 표준 .NET 스크래퍼를 차단하는 경우가 있습니다. CurlDotNet을 사용하여 표준 브라우저 사용자 에이전트를 쉽게 모방한 다음, IronOCR을 사용하여 텍스트를 읽을 수 있습니다.

using CurlDotNet;
using IronOcr;

// 1. Fetch the image using a specific browser User-Agent to bypass blocks
var imgResponse = await Curl.GetAsync("https://site.com/protected-captcha.png")
    .WithUserAgent("Mozilla/5.0 (Windows NT 10.0; Win64; x64)")
    .ExecuteAsync();

// 2. Use IronOCR to read text from the file bytes
var ocr = new IronTesseract();
using (var input = new OcrInput())
{
    input.AddImage(imgResponse.BodyBytes);
    var result = ocr.Read(input);

    // 3. Output the extracted string value
    Console.WriteLine($"OCR Result: {result.Text}");
}

using CurlDotNet;
using IronOcr;

// 1. Fetch the image using a specific browser User-Agent to bypass blocks
var imgResponse = await Curl.GetAsync("https://site.com/protected-captcha.png")
    .WithUserAgent("Mozilla/5.0 (Windows NT 10.0; Win64; x64)")
    .ExecuteAsync();

// 2. Use IronOCR to read text from the file bytes
var ocr = new IronTesseract();
using (var input = new OcrInput())
{
    input.AddImage(imgResponse.BodyBytes);
    var result = ocr.Read(input);

    // 3. Output the extracted string value
    Console.WriteLine($"OCR Result: {result.Text}");
}

OCR 예제 출력

예제 3: IronBarcode를 이용한 재고 관리

using CurlDotNet;
using IronBarCode;

class Program
{
    private static readonly HttpClient client = new HttpClient();
    public static async Task Main(string[] args)
    {

        // 1. Define the URL 
        string url = "https://barcodeapi.org/api/128/Shipping-Label-Test-123";

        try
        {
            // Add the session cookie to the request headers
            client.DefaultRequestHeaders.Add("Cookie", "session_id=xyz123");

            // 2. Download the image data as a Byte Array (Preserves binary integrity)
            byte[] imageBytes = await client.GetByteArrayAsync(url);

            Console.WriteLine($"Downloaded {imageBytes.Length} bytes.");

            // 3. Read the barcode directly from the byte array
            var result = BarcodeReader.Read(imageBytes);

            foreach (var barcode in result)
            {
                Console.WriteLine($"Detected Format: {barcode.BarcodeType}");
                Console.WriteLine($"Value: {barcode.Value}");
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }
}

using CurlDotNet;
using IronBarCode;

class Program
{
    private static readonly HttpClient client = new HttpClient();
    public static async Task Main(string[] args)
    {

        // 1. Define the URL 
        string url = "https://barcodeapi.org/api/128/Shipping-Label-Test-123";

        try
        {
            // Add the session cookie to the request headers
            client.DefaultRequestHeaders.Add("Cookie", "session_id=xyz123");

            // 2. Download the image data as a Byte Array (Preserves binary integrity)
            byte[] imageBytes = await client.GetByteArrayAsync(url);

            Console.WriteLine($"Downloaded {imageBytes.Length} bytes.");

            // 3. Read the barcode directly from the byte array
            var result = BarcodeReader.Read(imageBytes);

            foreach (var barcode in result)
            {
                Console.WriteLine($"Detected Format: {barcode.BarcodeType}");
                Console.WriteLine($"Value: {barcode.Value}");
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }
}