Ana içeriğe geç

Döviz Kuru

Para birimi dönüştürme oranını alır (Public - Authentication gerektirmez).

Endpoint​

GET /api/v1/currencies/exchange-rate

Authentication​

Bu endpoint authentication gerektirmez (Public).

Permission​

Gerekmez (Public endpoint).

Request​

Query Parameters​

ParametreTipZorunluAçıklama
fromstringEvetKaynak para birimi kodu (3 karakter, büyük harf, örn: USD)
tostringEvetHedef para birimi kodu (3 karakter, büyük harf, örn: TRY)
use_tcmbbooleanHayırTCMB servisini kullan (varsayılan: otomatik)

Response​

Success Response (200 OK)​

{
  "from": "USD",
  "to": "TRY",
  "rate": 32.50,
  "formatted": "1 USD = 32.50 TRY"
}

Error Responses​

400 Bad Request​

{
  "message": "Para birimi 'XXX' desteklenmiyor"
}

503 Service Unavailable​

{
  "message": "Döviz kuru alınamadı"
}

Code Examples​

cURL​

# USD'den TRY'ye döviz kuru
curl -X GET "https://api.example.com/api/v1/currencies/exchange-rate?from=USD&to=TRY"

# TCMB servisini kullan
curl -X GET "https://api.example.com/api/v1/currencies/exchange-rate?from=USD&to=TRY&use_tcmb=true"

Notes​

  • Public endpoint, authentication gerektirmez
  • Döviz kurları 48 saat cache'lenir (cache pattern: exchange_rate_{from}_{to})
  • TCMB XML servisi birincil kaynak, ExchangeRate-API fallback kaynak
  • Para birimi kodları 3 karakter, büyük harf olmalıdır (ISO 4217)