anyway.ro API Documentation

API Information

🔐 Authentication

All API endpoints require authentication using an API key.

⏱️ Rate Limits

📐 Data Standards (IATA Compliance)

Toate endpoint-urile respectă standarde IATA stricte. Codurile sunt reale, validate, și nu sunt inventate din primele litere ale numelui.

🎨 Airline Logos API

Access to 435 airline logos in multiple sizes (64x64, 28x28, 22x22 pixels)

{
  "success": true,
  "data": {
    "totalAirlines": 435,
    "airlines": [
      {
        "iataCode": "FR",
        "logoUrls": {
          "large": "https://static.ttm.network/images/airlines/64x64/FR.avif",
          "medium": "https://static.ttm.network/images/airlines/28x28/FR.avif",
          "small": "https://static.ttm.network/images/airlines/22x22/FR.avif"
        }
      }
    ]
  }
}

{
  "success": true,
  "data": {
    "iataCode": "FR",
    "logoUrls": {
      "large": "https://static.ttm.network/images/airlines/64x64/FR.avif",
      "medium": "https://static.ttm.network/images/airlines/28x28/FR.avif",
      "small": "https://static.ttm.network/images/airlines/22x22/FR.avif"
    }
  }
}

{
  "success": true,
  "data": {
    "iataCode": "FR",
    "logoUrl": "https://static.ttm.network/images/airlines/64x64/FR.avif",
    "size": "64x64"
  }
}

// Using fetch with API key in header
const response = await fetch('/api/airline-logos?code=FR&size=large', {
  headers: {
    'x-api-key': 'your_api_key_here'
  }
});
const data = await response.json();

// Or using query parameter
const response = await fetch(
  '/api/airline-logos?code=FR&size=large&api_key=your_api_key_here'
);

// Use in React component
<img 
  src={data.data.logoUrl} 
  alt="Ryanair logo" 
  width={64} 
  height={64} 
/>

🔍 Smart Search API

Căutare rute zbor (program săptămânal + destinații viitoare). Pentru asistenți AI și chatbot-uri: zbor direct, zile disponibile, listă destinații din origin, alternative multimodale.

GET /api/v1/smart-search?origin=RMO&destination=OTP
GET /api/v1/smart-search?origin=OTP&list_destinations_from_origin=1
GET /api/v1/smart-search?origin=Chișinău&list_destinations_from_origin=1
GET /api/v1/smart-search?origin=Lisabona&list_romd_destinations_from_origin=1
GET /api/v1/smart-search?origin=LIS&list_romd_destinations_from_origin=1&lang=en

{
  "status": "success",
  "direct_option": {
    "exists": true,
    "days": ["Mon", "Wed", "Fri", "Sun"],
    "schedule": {
      "Mon": ["06:30", "18:45"],
      "Wed": ["06:30"],
      "Fri": ["06:30", "18:45"],
      "Sun": ["18:45"]
    },
    "flights": [
      { "airline": "Wizz Air", "flightNumber": "W63201", "days": ["Mon", "Wed", "Fri"] },
      { "airline": "Wizz Air", "flightNumber": "W63205", "days": ["Mon", "Fri", "Sun"] }
    ],
    "day": "Mon",
    "details": "Zbor direct disponibil în zilele: Mon, Wed, Fri, Sun."
  },
  "multimodal_options": [],
  "ai_hint": "Există zbor direct București → London Stansted în ziua selectată.",
  "query": { "origin": "OTP", "destination": "STN", "originIata": "OTP", "destinationIata": "STN" }
}

{
  "status": "success",
  "destinations_from_origin": [
    { "city": "Berlin", "iata": "BER" },
    { "city": "Chicago", "iata": "ORD", "startsAt": "2026-06-04", "airline": "HiSky" }
  ],
  "ai_hint": "Din București (OTP) sunt 85 destinații cu zbor direct (inclusiv 1 care încep în perioada următoare). Spune o destinație și o zi (ex. „vineri”) sau „weekend"."
}

{
  "status": "success",
  "romd_destinations_from_origin": [
    {
      "to_city": "București",
      "to_iata": "OTP",
      "country": "România",
      "cityNames": { "ro": "București", "en": "Bucharest", "ru": "Бухарест" },
      "available_days": ["Tue", "Thu"],
      "schedule": { "Tue": ["07:30"], "Thu": ["18:15"] },
      "flights": [
        { "airline": "TAROM", "flightNumber": "RO707", "days": ["Tue", "Thu"] }
      ]
    },
    {
      "to_city": "Chișinău",
      "to_iata": "RMO",
      "country": "Moldova",
      "cityNames": { "ro": "Chișinău", "en": "Chisinau", "ru": "Кишинёв" },
      "available_days": ["Wed"],
      "flights": [
        { "airline": "HiSky", "flightNumber": "H4123", "days": ["Wed"] }
      ]
    }
  ],
  "locale": "ro",
  "ai_hint": "Din Lisabona (LIS) sunt 2 destinații directe în România/Moldova.",
  "query": { "origin": "Lisabona", "originIata": "LIS" }
}

📅 Future Destinations API

Destinații noi care încep zborurile într-o anumită perioadă (ex. Chișinău – Stuttgart, București – Chicago). Expuse public prin GET; administrare prin API admin (CRUD) sau panoul Admin → Destinații viitoare.

🗺️ Daily Routes API

Get daily route statistics for Romanian and Moldovan airports

{
  "success": true,
  "data": [
    {
      "airport": {
        "code": "OTP",
        "icao": "LROP",
        "name": "București Henri Coandă"
      },
      "routes": [
        {
          "destination": {
            "iata": "STN",
            "name": "London Stansted",
            "countryCode": "GB"
          },
          "flights": ["W63201", "W63205"],
          "operators": [
            { "name": "Wizz Air", "iata": "W6" }
          ],
          "flightTimes": [
            { "airline": "W6", "flightNumber": "W63201", "departureTime": "06:30", "days": ["Mon", "Wed", "Fri"] },
            { "airline": "W6", "flightNumber": "W63205", "departureTime": "18:45", "days": ["Tue", "Thu", "Sat", "Sun"] }
          ]
        },
        {
          "destination": {
            "iata": "DXB",
            "name": "Dubai",
            "countryCode": "AE"
          },
          "flights": ["FZ782"],
          "operators": [
            { "name": "flydubai", "iata": "FZ" }
          ],
          "flightTimes": [
            { "airline": "FZ", "flightNumber": "FZ782", "departureTime": "14:30", "days": ["Mon", "Wed", "Sun"] }
          ]
        }
      ],
      "fetchedAt": "2026-03-17T10:00:00Z"
    }
  ],
  "date": "2026-03-17",
  "totalAirports": 16
}

{
  "date": "2026-02-18",
  "airport": "OTP"  // optional, omit to refresh all
}

// Get all daily routes
const response = await fetch('/api/daily-routes', {
  headers: { 'x-api-key': 'your_api_key_here' }
});
const data = await response.json();

// Get routes for specific airport
const otpRoutes = await fetch('/api/daily-routes?airport=OTP', {
  headers: { 'x-api-key': 'your_api_key_here' }
});

// Refresh cache
await fetch('/api/daily-routes', {
  method: 'POST',
  headers: {
    'x-api-key': 'your_api_key_here',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ date: '2026-02-18' })
});

✈️ Flight Search API

Real-time flight search with schedule and delay information

{
  "success": true,
  "data": [
    {
      "flight_number": "FZ1732",
      "airline": {
        "name": "flydubai",
        "iata": "FZ"
      },
      "origin": {
        "iata": "OTP",
        "city": "Bucharest"
      },
      "destination": {
        "iata": "DXB",
        "city": "Dubai"
      },
      "scheduled_time": "2026-02-18T14:30:00Z",
      "estimated_time": "2026-02-18T14:45:00Z",
      "actual_time": null,
      "status": "delayed",
      "delay_minutes": 15,
      "gate": "A12",
      "terminal": "1",
      "aircraft": {
        "model": "Boeing 737-800",
        "registration": "A6-FEQ"
      },
      "codeshares": ["EK7932"],
      "data_quality": "Live"
    }
  ],
  "count": 1,
  "searchCriteria": {
    "origin": "OTP",
    "destination": "DXB",
    "date": "2026-02-18"
  },
  "dataQuality": "Live",
  "note": "Real-time data with delays and updates available."
}

// Search București-Dubai flights
const response = await fetch(
  '/api/flight-search?origin=OTP&destination=DXB',
  { headers: { 'x-api-key': 'your_api_key_here' } }
);
const data = await response.json();

// Display flight info
data.data.forEach(flight => {
  console.log(`Flight ${flight.flight_number}`);
  console.log(`Scheduled: ${flight.scheduled_time}`);
  console.log(`Estimated: ${flight.estimated_time}`);
  console.log(`Status: ${flight.status}`);
  console.log(`Delay: ${flight.delay_minutes} minutes`);
});

🤖 Instructiuni pentru LLM și Asistenți AI

Această secțiune explică pas cu pas cum poți folosi API-urile anyway.ro pentru a răspunde la întrebări despre zboruri („vreau să plec joi undeva, duminică înapoi”, „unde zboară din Cluj?”, „există zbor București–Londra miercuri?”). Poate fi folosită ca ghid pentru integrare în chatbot-uri, agenți AI sau documentație pentru modele LLM.

Pași recomandați (flux logic)

1. „Unde pot zbura din [oraș RO/MD]?” / „Ce destinații sunt din București?”
   • Apelează: GET /api/v1/smart-search?origin=OTP&list_destinations_from_origin=1 (înlocuiește OTP cu codul aeroportului: OTP=București, CLJ=Cluj, RMO=Chișinău etc.).
   • Origin poate fi IATA (3 litere) sau nume oraș (ex. origin=Chișinău).
   • Răspunsul conține destinations_from_origin (listă orașe + IATA) și ai_hint (text sugerat pentru utilizator).
2. „Din Lisabona/Paris/Londra ce orașe din România/Moldova am zbor direct?”
   • Apelează: GET /api/v1/smart-search?origin=Lisabona&list_romd_destinations_from_origin=1 (sau origin=LIS, origin=Paris).
   • Nu trimite destination.
   • Răspunsul conține romd_destinations_from_origin cu to_city, to_iata, country, zile și zboruri.
3. „Există zbor [origin] → [destinație] în [zi]?” / „Vreau București–Londra joi”
   • Convertește ziua în dată (ex. „joi” → următoarea joi în YYYY-MM-DD).
   • Apelează: GET /api/v1/smart-search?origin=OTP&destination=LHR&date=2026-03-12&include_schedule_days=1 (LHR=Londra Heathrow; poți folosi și BER, STN etc. pentru Londra/Berlin).
   • Sau pentru orar live + întârzieri: GET /api/flight-search?origin=OTP&destination=LHR&date=2026-03-12.
   • Răspunsul indică dacă există zbor direct, zilele din săptămână cu zboruri și (la flight-search) ore, status, întârzieri.
4. „Vreau să plec joi și să mă întorc duminică” (fără destinație fixă)
   • Cere: Din ce oraș pleci? (ex. București).
   • Apelează list_destinations_from_origin=1 pentru acel aeroport → obții lista de destinații.
   • Poți oferi utilizatorului lista și să îl lași să aleagă („Unde vrei să mergi? Berlin, Londra, Milano…”).
   • După ce alege destinația: apelează /api/v1/smart-search?origin=OTP&destination=BER&date=2026-03-12 (joi dus) și același origin/destination cu date=2026-03-15 (duminică întoarcere) sau /api/flight-search?origin=BER&destination=OTP&date=2026-03-15 pentru întoarcere.
5. „Câte zboruri sunt joi din Otopeni?” / „Rute zilnice pentru [aeroport] în [zi]”
   • Apelează: GET /api/daily-routes?airport=OTP&date=2026-03-12 (date = YYYY-MM-DD pentru joi respectivă).
   • Răspunsul conține routes (destinații + număr zboruri/zi). Pentru toate aeroporturile: GET /api/daily-routes?date=2026-03-12.
6. „Ce sosiri/plecări sunt acum la [aeroport]?” (live)
   • Plecări: GET /api/flights/[IATA]/departures (ex. /api/flights/OTP/departures).
   • Sosiri: GET /api/flights/[IATA]/arrivals. Nu necesită API key pentru aceste endpoint-uri.
   • Răspuns: listă zboruri cu scheduled_time, estimated_time, status, delay.
7. „Vreau opțiuni cu plecare luni/marți și întoarcere weekend” (planificator flexibil)
   • Apelează: POST /api/planificator-zboruri cu action: "search" și body: { "filters": { "departureDays": ["monday", "tuesday"], "returnDays": ["saturday", "sunday"], "departureTimeSlots": ["morning", "afternoon"], "returnTimeSlots": ["afternoon", "evening"] } }.
   • Răspuns: data = array de opțiuni (destinație + outboundFlights + returnFlights + totalOptions).
8. Destinații viitoare (rute noi anunțate)
   • GET /api/future-destinations — toate; ?origin=RMO sau ?origin=OTP pentru un aeroport. Fără autentificare.
   • Util pentru: „Ce rute noi sunt din Chișinău?” sau integrare în smart-search (deja incluse în list_destinations_from_origin cu startsAt și airline).

Tu ești asistent pentru zboruri din România și Moldova. Folosești API-ul anyway.ro.

Când utilizatorul vrea să plece „joi” și „duminică înapoi”:
1. Întreabă din ce oraș pleacă (București, Cluj, Chișinău etc.).
2. Dacă nu are destinație fixă: apelează GET .../api/v1/smart-search?origin=OTP&list_destinations_from_origin=1 (cu codul aeroportului) și oferă lista de destinații.
3. După ce alege destinația, convertește „joi” și „duminică” în date (YYYY-MM-DD) și apelează:
   - dus: GET .../api/v1/smart-search?origin=OTP&destination=BER&date=<data_joi>&include_schedule_days=1
   - întoarcere: GET .../api/flight-search?origin=BER&destination=OTP&date=<data_duminica>
4. Rezumat: afișează zborurile găsite cu ore, companie, status/întârziere dacă e cazul.

Autentificare: header x-api-key sau Authorization: Bearer <LOGISTICS_API_KEY> pentru /api/v1/smart-search. Endpoint-urile /api/flights/.../arrivals și .../departures și /api/daily-routes (GET) pot fi fără key pe anyway.ro.

⚠️ Error Responses

{
  "success": false,
  "error": "API key required",
  "message": "Please provide an API key in the x-api-key header or api_key query parameter"
}

{
  "success": false,
  "error": "Unauthorized",
  "message": "Invalid API key"
}

{
  "success": false,
  "error": "Rate limit exceeded",
  "message": "Rate limit exceeded: 1000 requests per minute"
}

{
  "success": false,
  "error": "Airline code not found",
  "code": "XX"
}

{
  "success": false,
  "error": "Invalid size. Use: 64x64, 28x28, 22x22, large, medium, or small"
}