Kur API

FX Bridge kurları Oracle ERP’ye yüklemenin yanında bir REST API de sunar. Ara katman yazılımınız, entegrasyon platformunuz veya betikleriniz kurları kaynak ve tarih vererek alabilir.

Kur API Enterprise plana dahildir. FX Bridge’in günlük kur arşivinden, Oracle ERP’ye yüklediği değerlerin aynısını döndürür.

Temel adres: https://api-fxbridge.experteamsolutions.com/api/v1

1. FX Bridge portalına giriş yapın ve menüden Kur API sayfasını açın.
2. Yeni API Anahtarı’na tıklayın, bir ad verin (örn. “ERP entegrasyonu”), geçerlilik süresini seçin, sunucularınızın genel IP’lerini girin, şifrenizle onaylayın ve anahtarı kopyalayın. Anahtar fxr_ ile başlar ve yalnızca bir kez gösterilir.
3. Anahtarı her istekte X-API-Key başlığında gönderin (aşağıdaki örneklere bakın).

Postman collection kullanımı

1. Aşağıdaki collection’ı indirin ve Postman’de içe aktarın (Import → dosyayı seçin).
2. Soldaki listede istek değil, collection adına (FX Bridge Rates API) tıklayın ve Variables sekmesini açın.
3. apiKey satırının değer alanına anahtarınızı yapıştırıp kaydedin (Cmd/Ctrl+S). Gizli (secret) bir değişkendir: değer maskeli görünür ve yalnızca sizin bilgisayarınızda kalır.
4. Anahtarlar yalnızca izin listesindeki IP’lerden çalışır: Postman’i çalıştırdığınız makinenin genel IP’sini portalda anahtara ekleyin (Kur API → IP’ler); aksi halde çağrılar 403 döner.
5. Başka bir kaynak veya tarih için source (örn. tcmb) ve rateDate (örn. 2026-08-18) değişkenlerini değiştirip Rates by source and date isteğini gönderin.
6. Bir isteğin Headers sekmesindeki X-API-Key satırı collection yetkilendirmesinden otomatik üretilir ve orada düzenlenemez; anahtarı her zaman apiKey değişkeninden girin.

Her istekte X-API-Key: fxr_... başlığı bulunmalıdır. Anahtarlar yalnızca SHA-256 hash olarak saklanır; kaybolan anahtar geri getirilemez, yenisini oluşturun.

Anahtarlar portaldan istenildiği an iptal edilebilir; iptal edilen anahtarla yapılan çağrılar hemen reddedilir. Organizasyonun Enterprise planı sona ererse, plan yenilenene kadar anahtarları reddedilir.

IP kısıtı (zorunlu): her anahtar, kendi sunucularınıza ait 1-5 genel IP adresine veya aralığına bağlıdır (örn. 198.51.100.10, 198.51.100.0/24). Aralıklar en fazla /24 (IPv6 /48) olabilir; özel (iç ağ) adresler kabul edilmez. Başka bir IP’den gelen çağrılar 403 ile reddedilir; böylece anahtar altyapınızın dışında kullanılamaz. Bu kuraldan önce oluşturulan anahtarlar, IP listesi eklenene kadar (portal → IP’ler) çalışmaz.

Geçerlilik süresi: her anahtarın bir süresi vardır (30 gün ile 2 yıl arası, varsayılan 1 yıl); süresi dolan anahtar 401 API key expired döner. Portal, 30 gün içinde sona erecek anahtarları işaretler.

Kesintisiz yenileme: Yenile, aynı ad ve IP listesiyle yeni bir anahtar üretir; eski anahtar 7 gün daha çalışır, sonra kendiliğinden sona erer.

Onay ve bildirim: anahtar oluşturma, yenileme ve IP listesini değiştirme portal şifrenizle onaylanır. Her oluşturma, yenileme, IP değişikliği ve iptal, işlemi yapanın IP adresiyle denetim kaydına yazılır ve hesap sahibine e-posta gönderilir.

Limit: anahtar başına dakikada 120 istek. Cevaplarda X-RateLimit-Limit ve X-RateLimit-Remaining başlıkları bulunur; limit aşılınca API Retry-After: 60 ile 429 döner.

Tüm trafik HTTPS’tir (TLS 1.2+).

Planınıza dahil kaynakları listeler.

GET https://api-fxbridge.experteamsolutions.com/api/v1/public/sources

latest_rate_date: null, FX Bridge’in o kaynak için henüz hiç kur tutmadığı anlamına gelir (örneğin ilk aylık hesaplamasından önce BMF).

{
  "data": [
    {
      "source": "tcmb",
      "name": "Central Bank of the Republic of Turkey (CBRT / TCMB)",
      "base_currency": "TRY",
      "rate_types": ["forex_buying", "forex_selling", "banknote_buying", "banknote_selling"],
      "latest_rate_date": "2026-09-21"
    },
    {
      "source": "ecb",
      "name": "European Central Bank",
      "base_currency": "EUR",
      "rate_types": ["reference"],
      "latest_rate_date": "2026-09-18"
    }
  ],
  "message": "13 source(s) available",
  "status": "success"
}

Bir kaynağın belirli bir tarih için yayınladığı kurları döndürür.

GET https://api-fxbridge.experteamsolutions.com/api/v1/public/rates/{source}/{date}

Parametreler

Cevap alanları

{
  "data": {
    "source": "tcmb",
    "source_name": "Central Bank of the Republic of Turkey (CBRT / TCMB)",
    "base_currency": "TRY",
    "requested_date": "2026-08-18",
    "rate_date": "2026-08-18",
    "rates": [
      {
        "currency": "USD",
        "rate_type": "forex_buying",
        "rate": "47.8109",
        "inverse_rate": "0.0209157326049"
      }
    ]
  },
  "message": "1 rate(s)",
  "status": "success"
}

Merkez bankaları farklı yönlerde yayın yapar: TCMB 1 USD = 47,8109 TRY yayınlarken ECB 1 EUR = 1,1576 USD yayınlar. API bunu normalize eder; kaynağın kuralını bilmeniz gerekmez.

• rate her zaman 1 birim currency’nin base_currency cinsinden değeridir. Oracle GL günlük kurunda FROM = currency, TO = base_currency karşılığıdır ve FX Bridge’in Oracle ERP’ye yüklediği değerdir.
• inverse_rate ters yöndür. ECB, HMRC ve BMF için bu, kaynağın yayınladığı değerin kendisidir.
• Örnek: TCMB USD → rate 47.8109 (1 USD = 47,8109 TRY), inverse_rate 0.0209157326049. ECB USD → rate 0.863856254319 (1 USD = 0,8639 EUR), inverse_rate 1.1576 (ECB’nin yayınladığı değer).
• Değerler, kayan nokta yuvarlamasını önlemek için ondalık metin (string) olarak döner; ondalık ayıracı noktadır. Hesaplanan ters kurlar 12 anlamlı basamaklıdır. 100 birim üzerinden kote edilen kurlar (örn. TCMB’de JPY) 1 birime çevrilir.

FX Bridge her kaynağı yayından kısa süre sonra otomatik olarak toplar. O saate kadar latest bir önceki yayını döndürür.

• İş günü kaynaklarında hafta sonu ve resmi tatillerde kayıt yoktur; bu tarihleri son yayını almak için fallback=true ile sorgulayın.
• Toplama saatleri sabit günlük takvimdir; bir gün geç yayın yapan kaynak bir sonraki çalışmada alınır.

TCMB kurları, Türkiye’deki muhasebe uygulamasına uygun olarak geçerli oldukları günün tarihiyle döner: İstanbul saatiyle 15:30’da açıklanan bülten ertesi günden itibaren geçerlidir.

• Örnek: /public/rates/tcmb/2026-08-18, 17 Ağustos 2026 saat 15:30’da açıklanan bülteni döndürür (USD döviz alış 47,8109). FX Bridge’in 18 Ağustos için Oracle ERP’ye yüklediği değer de budur.
• TCMB kayıtları takvimin her günü için vardır: cumartesi, pazar ve tatillerde son açıklanan bülten döner (pazartesi günü cuma bülteni döner).
• Bugünün TCMB kurları 02:00 UTC’de (05:00 İstanbul) hazır olur. TCMB’nin bugün öğleden sonra açıklayacağı bülten yarının tarihiyle görünür.
• TCMB dört kur tipi yayınlar: forex_buying (döviz alış), forex_selling (döviz satış), banknote_buying (efektif alış), banknote_selling (efektif satış).

• HMRC her ay için tek bir kur yayınlar, ay başlamadan önce. FX Bridge bu kuru ayın her günü için saklar; ay içindeki herhangi bir tarih o ayın kurunu döndürür.
• BMF (Almanya), ECB’nin aylık ortalamasıdır ve geriye dönük yayınlanır. Takip eden ayın 4’ünde hesaplanır ve o ayın her günü için saklanır; o güne kadar içinde bulunulan ayın tarihleri 404 döner.

Hata gövdeleri {"detail": "..."} biçimindedir.

• Kurlar FX Bridge arşivinden döner; arşiv, kaynağın FX Bridge’de etkinleştirildiği tarihten başlar. Daha eski geçmiş gerekiyorsa bize ulaşın.
• Geçmiş derinliği planınıza bağlıdır (Enterprise: 10 yıla kadar).
• Sorularınız için: info@experteamsolutions.com