National ID OCR API for Go: Raw HTTP for Maximum Control

package main

import (
	"bytes"
	"encoding/base64"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
	"os"
)

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

// --- Struct Definitions ---
type ApiResponse struct {
	Success bool           `json:"success"`
	Data    NationalIdData `json:"data"`
	Error   string         `json:"error,omitempty"`
}

type NationalIdData struct {
	CountryCode    string           `json:"country_code"`
	DocumentNumber string           `json:"document_number"`
	PersonalNumber string           `json:"personal_number"`
	CardSeries     string           `json:"card_series"`
	Surname        string           `json:"surname"`
	GivenNames     string           `json:"given_names"`
	Sex            string           `json:"sex"`
	DateOfBirth    string           `json:"date_of_birth"`
	Address        string           `json:"address"`
	Additional     AdditionalFields `json:"additional_fields"`
}

type AdditionalFields struct {
	MrzLine1 string `json:"mrz_line_1"`
	MrzLine2 string `json:"mrz_line_2"`
	MrzLine3 string `json:"mrz_line_3"`
}

func main() {
	apiURL := "https://api.structocr.com/v1/national-id"
	apiKey := "YOUR_API_KEY_HERE"
	imagePath := "id_card.jpg"

	imageBytes, err := os.ReadFile(imagePath)
	if err != nil { return }

	base64Image := base64.StdEncoding.EncodeToString(imageBytes)
	payload, _ := json.Marshal(map[string]string{"img": base64Image})

	req, _ := http.NewRequest("POST", apiURL, bytes.NewBuffer(payload))
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("x-api-key", apiKey)

	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil { return }
	defer resp.Body.Close()

	body, _ := io.ReadAll(resp.Body)

	var result ApiResponse
	if err := json.Unmarshal(body, &result); err != nil { return }

	if result.Success {
		data := result.Data
		fmt.Println("✅ National ID Extracted!")
		fmt.Printf("Doc Number: %s\n", data.DocumentNumber)
		fmt.Printf("Name:       %s %s\n", data.GivenNames, data.Surname)
		if data.Additional.MrzLine1 != "" {
			fmt.Printf("MRZ Line 1: %s\n", data.Additional.MrzLine1)
			fmt.Printf("MRZ Line 2: %s\n", data.Additional.MrzLine2)
		}
	}
}