High-Performance Go Library for HIN (Hull Identification Number) OCR

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

package main

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

func main() {
	apiKey := "YOUR_API_KEY" // Replace with your StructOCR API key
	imagePath := "./boat_hin.jpg" // Path to the hull image

	// 1. Read and encode the image
	imgBytes, err := os.ReadFile(imagePath)
	if err != nil {
		fmt.Println("Error reading file:", err)
		os.Exit(1)
	}
	imgBase64 := base64.StdEncoding.EncodeToString(imgBytes)

	// 2. Prepare the JSON payload
	payload := map[string]string{"img": imgBase64}
	payloadBytes, err := json.Marshal(payload)
	if err != nil {
		fmt.Println("Error marshaling JSON:", err)
		os.Exit(1)
	}

	// 3. Create the HTTP request targeting the HIN endpoint
	req, err := http.NewRequest("POST", "https://api.structocr.com/v1/hin", bytes.NewBuffer(payloadBytes))
	if err != nil {
		fmt.Println("Error creating request:", err)
		os.Exit(1)
	}

	req.Header.Set("x-api-key", apiKey)
	req.Header.Set("Content-Type", "application/json")

	// 4. Execute the request
	client := &http.Client{}
	res, err := client.Do(req)
	if err != nil {
		fmt.Println("Error making API request:", err)
		os.Exit(1)
	}
	defer res.Body.Close()

	// 5. Parse the structured response
	bodyBytes, _ := io.ReadAll(res.Body)
	var response map[string]interface{}
	if err := json.Unmarshal(bodyBytes, &response); err != nil {
		fmt.Println("Error decoding JSON response:", err)
		os.Exit(1)
	}

	// 6. Extract deeply parsed HIN data safely
	if isValid, ok := response["is_valid"].(bool); ok && isValid {
		hinNumber, _ := response["hin_number"].(string)
		confidence, _ := response["confidence"].(string)
		fmt.Printf("✅ Successfully Extracted HIN: %s (Confidence: %s)\n", hinNumber, confidence)

		if parsed, ok := response["parsed"].(map[string]interface{}); ok {
			manufacturer, _ := parsed["manufacturer_code"].(string)
			modelYear, _ := parsed["model_year"].(string)
			fmt.Printf("\tManufacturer: %s\n\tModel Year: %s\n", manufacturer, modelYear)
		}
	} else {
		fmt.Println("❌ API failed or HIN is invalid.")
		if errStr, ok := response["validation_error"].(string); ok && errStr != "" {
			fmt.Println("Validation Error:", errStr)
		}
	}
}