The Best PHP API for Shipping Container OCR

<?php

// Get 200 free credits:
// 👉 https://structocr.com/register

$imagePath = '/path/to/your/container_image.jpg'; // Replace with the actual path to your image
$apiKey = 'YOUR_API_KEY'; // Replace with your actual API key

// 1. Read the image file and encode it to Base64
$imageData = file_get_contents($imagePath);
if ($imageData === false) {
    die('Failed to read image file.');
}
$base64Image = base64_encode($imageData);

// 2. Prepare the API request payload
$payload = json_encode(['img' => $base64Image]);

// 3. Initialize cURL session targeting the container endpoint
$ch = curl_init('https://api.structocr.com/v1/container');

// 4. Configure cURL options
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $payload,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'x-api-key: ' . $apiKey,
        'Content-Type: application/json'
    ],
]);

// 5. Execute the API request
$response = curl_exec($ch);

// 6. Check for cURL errors
if (curl_errno($ch)) {
    die('cURL error: ' . curl_error($ch));
}

// 7. Close cURL session
curl_close($ch);

// 8. Decode the JSON response
$decodedResponse = json_decode($response, true);

// 9. Handle the API response
if ($decodedResponse === null) {
    die('Failed to decode JSON response: ' . $response);
}

if (isset($decodedResponse['success']) && $decodedResponse['success']) {
    $data = $decodedResponse['data'];

    echo "✅ Extraction Successful!\n";
    echo "Container Number: " . $data['container_number'] . "\n";
    echo "Is Valid (ISO 6346): " . ($data['is_valid'] ? 'Yes' : 'No') . "\n";
    echo "Confidence: " . $data['confidence'] . "\n\n";

    $parsed = $data['parsed'];
    echo "--- Parsed Details ---\n";
    echo "Owner Code: " . $parsed['owner_code'] . "\n";
    echo "Category: " . $parsed['category'] . "\n";
    echo "Serial Number: " . $parsed['serial_number'] . "\n";
    echo "Check Digit: " . $parsed['check_digit'] . "\n";

} else {
    echo "❌ Error: " . ($decodedResponse['error'] ?? 'Unknown API error') . "\n";
}

?>