Automated Hotel Check-In Passport Scanner API

import requests
import base64

# 📚 Developer Docs: https://structocr.com/developers/passport-ocr

# Note: StructOCR is strictly a REST API. Send Base64 natively 
# from your PMS backend or kiosk software without installing any SDKs.

with open("guest_passport.jpg", "rb") as image_file:
    base64_image = base64.b64encode(image_file.read()).decode('utf-8')

url = "https://api.structocr.com/v1/passport"
headers = {
    "x-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "img": base64_image
}

try:
    # Relayed through Cloudflare Edge for sub-second parsing
    print("Processing Guest Check-In...")
    response = requests.post(url, headers=headers, json=payload)
    result = response.json()

    if result.get('success'):
        print("✅ Guest Data Extraction Complete!\n")
        
        # Standardized Data for the PMS
        core = result['data']
        print(f"Guest:       {core.get('given_names')} {core.get('surname')}")
        print(f"Nationality: {core.get('nationality')}")
        print(f"Doc No:      {core.get('passport_number')} ({core.get('country_code')})")
        print(f"DOB:         {core.get('date_of_birth')} (ISO 8601)")
    else:
        print(f"❌ Extraction Failed: {result.get('error')} - {result.get('message')}")
except Exception as e:
    print(f"Error: {e}")