Direct API for High-Accuracy C# National ID Extraction

// 💰 Save 30%+ vs competitors. Get 200 free requests instantly:
// 👉 https://structocr.com/register

using System;
using System.IO;
using System.Net.Http;
using System.Net.Http.Json;
using System.Text.Json;
using System.Text.Json.Serialization;
using System.Threading.Tasks;

public class NationalIdOcrExample
{
    // 🔑 Need a key? Get 200 free requests instantly (No Credit Card required):
    // 👉 https://structocr.com/register
    private const string ApiKey = "YOUR_API_KEY_HERE";
    private const string ApiEndpoint = "https://api.structocr.com/v1/national-id";

    private static readonly HttpClient client = new HttpClient();

    public static async Task Main(string[] args)
    {
        // Note: Supports JPG, PNG, WebP (Max 4.5MB)
        string imagePath = "id_card.jpg";

        if (!File.Exists(imagePath))
        {
            Console.WriteLine($"Error: File not found at {imagePath}");
            return;
        }

        try
        {
            // 1. Prepare Payload
            byte[] imageBytes = await File.ReadAllBytesAsync(imagePath);
            string base64Image = Convert.ToBase64String(imageBytes);
            var payload = new { img = base64Image };

            // 2. Setup Request
            client.DefaultRequestHeaders.Clear();
            client.DefaultRequestHeaders.Add("x-api-key", ApiKey); // Required Header

            // 3. Send POST Request
            Console.WriteLine($"Scanning ID card at {ApiEndpoint}...");
            HttpResponseMessage response = await client.PostAsJsonAsync(ApiEndpoint, payload);

            // 4. Handle Response
            string responseBody = await response.Content.ReadAsStringAsync();

            if (!response.IsSuccessStatusCode)
            {
                Console.WriteLine($"API Error ({response.StatusCode}): {responseBody}");
                return;
            }

            // 5. Deserialize JSON
            var options = new JsonSerializerOptions { PropertyNameCaseInsensitive = true };
            var result = JsonSerializer.Deserialize<ApiResponse>(responseBody, options);

            if (result?.Success == true && result.Data != null)
            {
                var data = result.Data;
                Console.WriteLine("✅ Extraction Successful!");
                Console.WriteLine($"Region:     {data.CountryCode} (Series: {data.CardSeries})");
                Console.WriteLine($"Name:       {data.GivenNames} {data.Surname}");
                Console.WriteLine($"ID Number:  {data.DocumentNumber}");
                Console.WriteLine($"Personal #: {data.PersonalNumber} (CNP/CPF/NIN)");
                Console.WriteLine($"DOB:        {data.DateOfBirth} (Sex: {data.Sex})");
                Console.WriteLine($"Address:    {data.Address}");
            }
            else
            {
                Console.WriteLine("Extraction Failed.");
            }
        }
        catch (Exception e)
        {
            Console.WriteLine($"Unexpected Error: {e.Message}");
        }
    }
}

// --- Data Models matching the Schema ---
public class ApiResponse
{
    public bool Success { get; set; }
    public IdData Data { get; set; }
}

public class IdData
{
    [JsonPropertyName("country_code")]
    public string CountryCode { get; set; }
    
    [JsonPropertyName("document_number")]
    public string DocumentNumber { get; set; }

    [JsonPropertyName("personal_number")]
    public string PersonalNumber { get; set; }

    [JsonPropertyName("card_series")]
    public string CardSeries { get; set; }

    public string Surname { get; set; }
    
    [JsonPropertyName("given_names")]
    public string GivenNames { get; set; }
    
    public string Sex { get; set; }
    
    [JsonPropertyName("date_of_birth")]
    public string DateOfBirth { get; set; }
    
    public string Address { get; set; }
}