أمثلة استخدام API

استبدل API_BASE بعنوان API الفعلي وfiyafi_your_key_here بمفتاح صالح.

cURL - Search جدة

curl -X GET "$API_BASE/v1/airports/search?q=جدة&lang=ar&limit=10" \
  -H "x-api-key: fiyafi_your_key_here"

JavaScript - Autocomplete جدة

const res = await fetch(`${API_BASE}/v1/airports/autocomplete?q=جد&lang=ar`, {
  headers: { "x-api-key": "fiyafi_your_key_here" }
});
const data = await res.json();

PHP / Laravel - IATA JED

$response = Http::withHeaders([
    'x-api-key' => 'fiyafi_your_key_here',
])->get(env('FIYAFI_API_BASE').'/v1/airports/iata/JED');

$airport = $response->json();

Python - Nearby

import requests

res = requests.get(
    f"{API_BASE}/v1/airports/nearby",
    params={"lat": 21.5433, "lon": 39.1728, "limit": 5},
    headers={"x-api-key": "fiyafi_your_key_here"},
)
print(res.json())

Bulk lookup JED/RUH/DMM/TBS

curl -X POST "$API_BASE/v1/airports/bulk" \
  -H "Content-Type: application/json" \
  -H "x-api-key: fiyafi_your_key_here" \
  -d '{"codes":["JED","RUH","DMM","TBS"]}'

Error response example

{
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Invalid or missing API key",
    "message_ar": "مفتاح API غير صالح أو مفقود"
  }
}