{"success":true,"message":"Welcome to TrueSkies Backend API!","version":"2.0.0","architecture":"aeroapi-only","note":"All flight endpoints require explicit search parameters - no automatic flight display","endpoints":{"health":"/health","enhancedFlights":{"search":"/api/enhanced-flights/search?query=UAL123&limit=25 (PRIMARY: query parameter required)","details":"/api/enhanced-flights/UAL123/details (REQUIRED: flight ID)","aircraft":"/api/enhanced-flights/aircraft/N12345 (REQUIRED: aircraft ID)","status":"/api/enhanced-flights/service/status"},"userFlights":{"list":"/api/user-flights (GET: user tracked flights)","add":"/api/user-flights (POST: add flight)","details":"/api/user-flights/:id (GET: flight details)","sync":"/api/user-flights/sync (POST: sync from client)"},"flights":{"search":"/api/flights/search?query=UAL123&limit=25 (REQUIRED: query parameter)","details":"/api/flights/UAL123/details (REQUIRED: flight ID)","stats":"/api/flights/stats"},"aeroApi":{"departures":"/api/aeroapi/airports/LAX/departures?limit=50 (REQUIRED: airport code)","arrivals":"/api/aeroapi/airports/JFK/arrivals?limit=50 (REQUIRED: airport code)","schedule":"/api/aeroapi/flights/UAL123/schedule (REQUIRED: flight number)","aircraft":"/api/aeroapi/aircraft/N12345 (REQUIRED: aircraft registration)","status":"/api/aeroapi/status"},"auth":{"demoKeys":"/api/auth/demo-keys","test":"/api/auth/test","me":"/api/auth/me"},"admin":{"cacheStatus":"/api/admin/cache/status","workerStats":"/api/admin/worker/stats","forceRefresh":"POST /api/admin/worker/force-fetch","config":"/api/admin/config","apiKeys":"/api/admin/api-keys","regions":"/api/admin/regions (DEPRECATED)"},"reference":{"stats":"/api/reference/stats","airlines":"/api/reference/airlines?search=United","airlineByCode":"/api/reference/airlines/UAL","airports":"/api/reference/airports?search=Los%20Angeles","airportByCode":"/api/reference/airports/LAX","aircraft":"/api/reference/aircraft?manufacturer=Boeing","aircraftByCode":"/api/reference/aircraft/B738","timezones":"/api/reference/timezones"},"alerts":{"webhook":"POST /api/alerts/webhook (FlightAware callback)","webhookTest":"GET /api/alerts/webhook/test","subscribe":"POST /api/alerts/subscribe","unsubscribe":"DELETE /api/alerts/unsubscribe/:alertId","myAlerts":"GET /api/alerts/my-alerts?deviceToken=...","flightAlerts":"GET /api/alerts/flight/:flightIdent","registerDevice":"POST /api/alerts/register-device (Register device token for user)","stats":"GET /api/alerts/stats (admin)","configureWebhook":"POST /api/alerts/webhook/configure (admin)","cleanup":"POST /api/alerts/cleanup (admin)"},"profile":{"get":"GET /api/profile (Get user profile)","update":"PUT /api/profile (Update user profile)","registerDevice":"POST /api/profile/register-device (Register device for recovery)","checkRecovery":"GET /api/profile/check-recovery?device_id=... (Check for profile recovery)"},"passportVisa":{"countries":"/api/passport-visa/countries?search=United","check":"/api/passport-visa/check?passport=United%20States&destination=France","passportInfo":"/api/passport-visa/passport/United%20States","visaFree":"/api/passport-visa/visa-free/United%20States","visaRequired":"/api/passport-visa/visa-required/Afghanistan","ranking":"/api/passport-visa/ranking/US","rankingHistory":"/api/passport-visa/ranking/US/history?fromYear=2006&toYear=2025","stats":"/api/passport-visa/stats"},"visaSync":{"status":"GET /api/admin/visa-sync/status (Sync status and stats)","fullSync":"POST /api/admin/visa-sync/full (Full sync from Henley API)","countrySync":"POST /api/admin/visa-sync/country/:code (Sync single country)","rankingsSync":"POST /api/admin/visa-sync/rankings (Sync rankings only)"}},"authentication":{"required":"All API endpoints require authentication","methods":["Authorization: Bearer <api_key>","X-API-Key: <api_key>"],"getKeys":"Visit /api/auth/demo-keys for available test keys or /api/admin/api-keys to create new keys"},"documentation":{"search":"Search flights by callsign, route, or aircraft - requires query parameter","details":"Get detailed information about a specific flight - requires flight ID","userFlights":"Personal tracked flights with hybrid sync (Core Data local + Supabase cloud)","stats":"Get server and cache statistics","behavior":"NO flights are returned without explicit search criteria (query or ID)"}}