Curl DotNet: Trazendo os superpoderes do Curl para o .NET Runtime

Principais características

• Tradução Zero: Cole comandos curl HTTPS diretamente no seu código-fonte C#.

• Multiplataforma: Suporte completo para Windows, Linux, MacOS e mais.

• Segurança de Tipo: Opção para usar um construtor fluente para cenários de injeção de dependência.

• Observabilidade: Suporte embutido para emitir eventos estruturados para registro.

A API de String: Cole e Use Comandos Curl

Este método é perfeito para verificações de saúde, agentes de suporte ou prototipagem rápida. Você simplesmente passa o comando curl como uma string.

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

Usando o Construtor Fluente com Variáveis de Ambiente

Para aplicações de produção onde você precisa lidar com dados sensíveis via variáveis de ambiente, ou requer uma arquitetura mais limpa, o construtor fluente é ideal. Você pode especificar um nome de string para cabeçalhos ou definir um caminho de arquivo explicitamente.

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();

Exemplo 1: Download Seguro de PDF e Edição com IronPDF

IronPDF é o padrão da indústria para gerar PDFs com perfeição de pixel em .NET. Ao contrário de outras bibliotecas que têm dificuldades com padrões web modernos, o IronPDF renderiza HTML, CSS e JavaScript exatamente como um navegador Chrome faria. Ele é construído para ser uma solução completa: você pode gerar novos documentos a partir de strings HTML ou arquivos, editar PDFs existentes, mesclar documentos e aplicar recursos de segurança como marca d'água e criptografia sem a necessidade de dependências externas ou Adobe Acrobat instalado no servidor.

Imagine que você precisa baixar uma fatura gerada de um sistema interno legado que requer flags curl complexas (como ignorar erros de SSL ou permutações de cabeçalho específicas), e então marcá-lo com o IronPDF.

Traduzir esse pedido para HttpClient pode levar horas de depuração. Com CurlDotNet, você cola o comando, obtém os bytes e os entrega ao 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.");
}

Confirmação no Console

Saída em PDF

Exemplo 2: Raspagem e OCR com IronOCR

IronOCR é uma biblioteca avançada de reconhecimento óptico de caracteres alimentada pelo motor Tesseract 5, afinada especificamente para C# e .NET. Ele suporta mais de 127 idiomas e se destaca na leitura de texto de fontes imperfeitas—pense em digitalizações de baixa resolução, imagens rotacionadas ou fundos ruidosos. Suas capacidades de "Visão Computacional" permitem que detecte regiões de texto automaticamente, e ele pode produzir dados não apenas como strings simples, mas como conteúdo estruturado (códigos de barras, parágrafos, linhas e caracteres) para análise profunda.

Às vezes você precisa extrair dados de uma imagem hospedada em um servidor que bloqueia raspadores padrão .NET. Você pode usar o CurlDotNet para imitar um agente de usuário de navegador padrão sem esforço e, em seguida, usar o IronOCR para ler o texto.

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}");
}

Exemplo de Saída OCR

Exemplo 3: Gerenciamento de Inventário com 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}");
        }
    }
}