Curl DotNet: Llevando los superpoderes de Curl al tiempo de ejecución de .NET

Características clave

• Cero Traducción: Pegue los comandos HTTPS de curl directamente en su código fuente de C#.

• Multiplataforma: Compatibilidad total con Windows, Linux, MacOS, etc.

• Seguridad tipográfica: Opción de utilizar un constructor fluido para escenarios de inyección de dependencias.

• Observabilidad: Soporte incorporado para emitir eventos estructurados para el registro.

La API de cadenas: Comandos Paste y Go Curl

Este método es perfecto para comprobaciones de estado, agentes de soporte o creación rápida de prototipos. Basta con pasar el comando curl como una cadena.

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

IRON VB CONVERTER ERROR developers@ironsoftware.com

Uso de Fluent Builder con variables de entorno

Para aplicaciones de producción en las que sea necesario manejar datos sensibles a través de variables de entorno, o que requieran una arquitectura más limpia, el constructor fluido es ideal. Puede especificar un nombre de cadena para las cabeceras o establecer una ruta de archivo explícitamente.

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

IRON VB CONVERTER ERROR developers@ironsoftware.com

Ejemplo 1: Descarga y edición seguras de PDF con IronPDF

IronPDF es el estándar del sector para la generación de archivos PDF perfectos en .NET. A diferencia de otras bibliotecas que luchan con los estándares web modernos, IronPDF reproduce HTML, CSS y JavaScript exactamente como lo haría un navegador Chrome. Está diseñado para ser una solución completa: puede generar nuevos documentos a partir de cadenas HTML o archivos, editar PDF existentes, fusionar documentos y aplicar funciones de seguridad como marcas de agua y cifrado sin necesidad de dependencias externas ni de Adobe Acrobat instalado en el servidor.

Imagine que necesita descargar una factura generada desde un sistema interno heredado que requiere banderas curl complejas (como ignorar errores SSL o permutaciones de encabezado específicas) y, a continuación, marcarla con IronPDF.

Traducir esa petición a HttpClient puede llevar horas de depuración. Con CurlDotNet, se pega el comando, se obtienen los bytes y se entregan a 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.");
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Confirmación de la consola

Confirmación escrita en la consola confirmando que el PDF está guardado

Resultado PDF

Archivo PDF de ejemplo

Ejemplo 2: Scraping y OCR con IronOCR

IronOCR es una biblioteca avanzada de reconocimiento óptico de caracteres basada en el motor Tesseract 5, ajustada específicamente para C# y .NET. Es compatible con más de 127 idiomas y destaca en la lectura de texto de fuentes imperfectas, como escaneos de baja resolución, imágenes giradas o fondos ruidosos. Sus funciones de "visión por ordenador" le permiten detectar regiones de texto automáticamente, y puede generar datos no solo como cadenas simples, sino como contenido estructurado (códigos de barras, párrafos, líneas y caracteres) para un análisis en profundidad.

A veces es necesario extraer datos de una imagen alojada en un servidor que bloquea los scrapers .NET estándar. Puede utilizar CurlDotNet para imitar un agente de usuario de navegador estándar sin esfuerzo y, a continuación, utilizar IronOCR para leer el 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}");
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Ejemplo de salida deOCR

Ejemplo de uso de IronOCR con CurlDotNet

Ejemplo 3: Gestión de inventario con 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}");
        }
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com