Skip to main content

Para Birimi Dönüştürme

Para birimi dönüştürme işlemi yapar (Public - Authentication gerektirmez).

Endpoint​

GET /api/v1/currencies/convert

Authentication​

Bu endpoint authentication gerektirmez (Public).

Permission​

Gerekmez (Public endpoint).

Request​

Query Parameters​

ParametreTipZorunluAçıklama
amountnumericEvetDönüştürülecek miktar (min: 0)
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)​

{
  "amount": 100,
  "from": "USD",
  "to": "TRY",
  "rate": 32.50,
  "converted": 3250.00,
  "formatted": {
    "from": "$100.00",
    "to": "₺3,250.00"
  }
}

Error Responses​

400 Bad Request​

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

503 Service Unavailable​

{
  "message": "Para birimi dönüştürme yapılamadı"
}

Code Examples​

cURL​

# 100 USD'yi TRY'ye dönüştür
curl -X GET "https://api.example.com/api/v1/currencies/convert?amount=100&from=USD&to=TRY"

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

Notes​

  • Public endpoint, authentication gerektirmez
  • Döviz kurları 48 saat cache'lenir
  • TCMB XML servisi birincil kaynak, ExchangeRate-API fallback kaynak
  • Sonuç formatlanmış olarak döner (hem ham hem formatlanmış değerler)