Mobil Flutter uygulaması herkese açık bir istemcidir; exchangerate.dev bearer anahtarını içermemelidir. Anahtarı küçük bir sunucu tarafı /api/fx proxy’sine koyun, Flutter’ın {from,to} istemesini sağlayın ve dönen kur, kaynak, piyasa oturumu ve gözlem zamanını tip güvenli modelde birlikte tutun.
- İndirilebilir Dart dosyası uygulamadan exchangerate.dev anahtarını değil, proxy’nizi çağırır.
- Yanıt modeli render etmeden önce rate ve data_updated_at değerlerini doğrular.
- Yüklenme, HTTP/format hataları, kaynak, piyasa oturumu ve cache yaşı görünürdür.
- Görüntü sabit ondalık kullanır; yuvarlanmamış API değeri uygulama kodunda kalır.
- Gösterge kurları tahmin ve görüntüleme içindir; takas sorumlu ödeme sağlayıcısına aittir.
Kimlik bilgisini sunucunun arkasına koyun
Sunucu rotanız from ve to kabul eder, Authorization: Bearer $EXCHANGERATE_API_KEY ekler, /v1/latest/{from}?symbols={to} çağırır ve uygulamanın ihtiyacı olan alanları döndürür. Anahtarı sunucu ortamında tutun. Uygulama proxy URL’sini --dart-define=FX_PROXY_BASE_URL=… ile alır; upstream anahtarı hiçbir zaman almaz.
GET /api/fx?from=USD&to=EUR{"from":"USD","to":"EUR","rate":0.9245,"source":"live","market_session":"open","data_updated_at":"2026-09-29T10:00:00Z"}HTTP bağımlılığını ekleyin
Bir Flutter uygulaması oluşturun, güncel http paketini pubspec.yaml dosyasına ekleyin ve tam Flutter dönüştürücüyü lib/main.dart olarak kaydedin. flutter run --dart-define=FX_PROXY_BASE_URL=https://your-app.example/api/fx ile çalıştırın. Minimal Node proxy’yi indirin, sunucu ortamında EXCHANGERATE_API_KEY ayarlayın ve Node 20 veya daha yenisiyle node flutter-currency-converter-proxy.mjs çalıştırın. Yerel testte loopback 8787 portunu dinler. Bir cihaz bağlamadan önce kendi kimlik doğrulamalı HTTPS backend’iniz ve istek limitleriniz üzerinden yayınlayın; dosya para birimi ve tutarı doğrular, anahtarı iletir ve yalnızca gereken tip güvenli kotasyon alanlarını döndürür. Standart Flutter Material widget’larını ve tip güvenli FxQuote modelini kullanır. Flutter’ın resmi networking tarifi paket kurulumunu ve istek desenini açıklar.
Render etmeden önce kotasyonu doğrulayın
Model eksik, pozitif olmayan, sonlu olmayan veya sayısal olmayan rate ile eksik data_updated_at değerini reddeder. Böylece HTML hata sayfası, proxy hatası veya boş JSON dönüşüm ekranına girmez. İstemci ayrıca isteği on saniyeyle sınırlar ve 2xx dışı durumları gösterir.
class FxQuote { final String from; final String to; final double rate; final String source; final String marketSession; final DateTime dataUpdatedAt;}Yüklenme, hata ve tazeliği gösterin
Ekran istek sürerken düğmeyi devre dışı bırakır, ilerleme göstergesi gösterir ve proxy başarısız olduğunda okunabilir hata tutar. Başarıdan sonra tutarı, görüntülenen kuru, kaynağı, piyasa oturumunu, gözlem zamanını, uygulama cache yaşını (cihazın yanıtı yüklemesinden beri geçen süre) ve gözlem yaşını (data_updated_at üzerinden) gösterir. Kullanıcı verinin canlı işlem günü gözlemi mi yoksa günlük referans mı olduğunu görebilir.
Görüntü için yuvarlayın, değeri koruyun
Örneğin desteklenen para birimlerinde JPY’yi 0, USD, EUR, GBP ve IDR’yi 2 ondalıkla gösterin; okunabilirlik için kuru 6 ondalıkla gösterin. Bu yalnızca sunum yuvarlamasıdır. Ayrıştırılmış sayısal kuru koruyun ve üretim muhasebe sınırında decimal veya fixed-point stratejisi kullanın; ikili kayan noktalı görüntü değerini takas kaydı yapmayın.
Obfuscation, derleme zamanı sabitleri ve özel Flutter deposu, uygulama dağıtıldığında anahtarı gizli yapmaz. Proxy sınırı tasarımın parçasıdır; isteğe bağlı bir sertleştirme değildir.
Müşteri yolunu test edin
Uygulamayı test proxy yanıtıyla çalıştırın; ardından timeout, HTTP 401/429, bozuk JSON, eksik kur ve eski data_updated_at durumlarını deneyin. Flutter’a özgü ağ, TLS ve proxy dağıtımı gerçek cihaz veya emülatörle de test edilmelidir; indirilebilir dosya çalıştırılabilir istemci örneğidir, barındırılan proxy değildir.
Sonucu dönüşüm tahmini, görüntüleme ve analiz için kullanın. Ödeme sağlayıcısı veya düzenlenen sistem kendi çalıştırılabilir kotasyonunu ve takas kaydını alıp saklamalıdır.