Direct HTTP API for National ID Data Extraction in Java

import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.file.Files;
import java.nio.file.Path;
import java.time.Duration;
import java.util.Base64;

public class NationalIdOcrExample {

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

    private static final String API_KEY = "YOUR_API_KEY_HERE";
    private static final String API_ENDPOINT = "https://api.structocr.com/v1/national-id";

    public static void main(String[] args) {
        // Note: Supports JPG, PNG, WebP (Max 4.5MB)
        String imagePath = "id_card.jpg";

        try {
            // 1. Validate File
            Path path = Path.of(imagePath);
            if (!Files.exists(path)) {
                System.err.println("Error: File not found at " + path.toAbsolutePath());
                return;
            }

            // 2. Read and Encode Image
            byte[] imageBytes = Files.readAllBytes(path);
            String base64Image = Base64.getEncoder().encodeToString(imageBytes);

            // 3. Construct JSON Payload (Dependency-free)
            // For production, use Jackson or Gson.
            String jsonPayload = "{\"img\": \"" + base64Image + "\"}";

            // 4. Create HttpClient
            HttpClient client = HttpClient.newBuilder()
                    .version(HttpClient.Version.HTTP_1_1)
                    .connectTimeout(Duration.ofSeconds(10))
                    .build();

            // 5. Build Request
            // Important: 'x-api-key' is required in the header
            HttpRequest request = HttpRequest.newBuilder()
                    .uri(URI.create(API_ENDPOINT))
                    .header("Content-Type", "application/json")
                    .header("x-api-key", API_KEY)
                    .timeout(Duration.ofSeconds(30))
                    .POST(HttpRequest.BodyPublishers.ofString(jsonPayload))
                    .build();

            System.out.println("Scanning ID card at " + API_ENDPOINT + "...");

            // 6. Send Request
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

            // 7. Output Result
            if (response.statusCode() == 200) {
                System.out.println("✅ Extraction Successful!");
                // Parse the JSON response here to access specific fields (e.g., 'personal_number')
                // Note: Raw MRZ data (if present) is located inside the 'additional_fields' object.
                System.out.println(response.body());
            } else {
                System.err.println("❌ API Error: " + response.statusCode());
                System.err.println(response.body());
            }

        } catch (IOException | InterruptedException e) {
            System.err.println("Request failed: " + e.getMessage());
            Thread.currentThread().interrupt();
        }
    }
}