Python ile kendi basit döviz çevirici API istemcinizi adım adım nasıl yazarsınız?

Günümüzün küreselleşmiş dünyasında, farklı para birimleri arasında hızlı ve doğru dönüşümler yapmak yaygın bir ihtiyaçtır. İster uluslararası ticaretle uğraşıyor olun, ister yurt dışına seyahat planlıyor olun, güncel döviz kurlarına erişim hayati önem taşır. Bu makalede, Python programlama dilini kullanarak gerçek zamanlı döviz kurlarına erişebilen basit bir API istemcisi oluşturmayı adım adım öğreneceğiz. Bu proje, sadece pratik bir araç sağlamakla kalmayacak, aynı zamanda API'lerle nasıl etkileşime girileceği ve dış kaynaklardan veri çekme mantığı hakkında temel bir anlayış kazanmanızı sağlayacaktır. AdSense politikalarına uygun, yüksek kaliteli ve bilgilendirici bir içerik sunarak, okuyucularımıza değerli bir öğrenme deneyimi vaat ediyoruz.

Neden Kendi Döviz Çevirici API İstemcinizi Yazmalısınız?

>

Hazır uygulamalar varken neden kendi döviz çeviricinizi yazasınız? Bunun birkaç nedeni var:

1. Öğrenme Fırsatı: API'lerin nasıl çalıştığını, HTTP isteklerini nasıl yöneteceğinizi ve JSON verilerini nasıl ayrıştıracağınızı öğrenmek için harika bir yoldur.
2. Esneklik: Kendi aracınızı oluşturduğunuzda, tam olarak istediğiniz özellikleri ekleyebilir ve belirli ihtiyaçlarınıza göre uyarlayabilirsiniz.
3. Temel Beceriler: Bu tür projeler, daha karmaşık web uygulamaları veya veri analiz projeleri için temel oluşturur.
4. Kontrol: Verilerinizi ve uygulamanızın performansını tamamen siz kontrol edersiniz.

Bu rehber, sıfırdan başlayarak çalışan bir döviz çevirici oluşturmanız için size yol gösterecektir.

Başlamadan Önce: Gerekli Önkoşullar

>

Bu projeye başlamadan önce aşağıdaki maddelerin hazır olduğundan emin olun:

* Python Yüklü: Bilgisayarınızda Python 3.x sürümünün yüklü olması gerekmektedir. Yüklü olup olmadığını kontrol etmek için terminal veya komut istemcisinde `python3 --version` komutunu çalıştırabilirsiniz.
* Temel Python Bilgisi: Değişkenler, fonksiyonlar, if/else koşulları gibi temel Python sözdizimlerine aşina olmanız faydalı olacaktır.
* İnternet Bağlantısı: API'ye istek göndermek için aktif bir internet bağlantısı gereklidir.

Adım 1: Bir Döviz Kuru API'si Seçmek ve API Anahtarı Almak

>

Çalışan bir döviz çevirici oluşturmak için güncel döviz kurlarını sağlayan bir API'ye ihtiyacımız var. Piyasada birçok ücretsiz ve ücretli API bulunmaktadır. Bu rehber için, kullanımı kolay ve ücretsiz katmanı olan [ExchangeRate-API](https://www.exchangerate-api.com/) servisini kullanacağız.

1. ExchangeRate-API Sitesine Gidin: Tarayıcınızda www.exchangerate-api.com adresine gidin.
2. Kaydolun ve Ücretsiz Anahtar Alın: "Get Free API Key" butonuna tıklayarak basit bir kayıt sürecini tamamlayın. Kayıt olduktan sonra size özel bir API anahtarı (API Key) verilecektir. Bu anahtarı güvende tutun, çünkü API'ye istek göndermek için bu anahtara ihtiyacımız olacak.

Alternatif olarak, farklı özellikler sunan Open Exchange Rates veya Fixer.io gibi diğer API servislerini de değerlendirebilirsiniz. Her API'nin kendine özgü sınırlamaları ve kullanım koşulları olabileceğini unutmayın.

Adım 2: Gerekli Python Kütüphanelerini Yüklemek

>

Python ile HTTP istekleri yapmak için genellikle `requests` kütüphanesini kullanırız. Bu kütüphane, web servisleriyle etkileşim kurmayı son derece kolaylaştırır. `requests` kütüphanesi Python'ın standart kütüphanesinde gelmez, bu yüzden onu yüklememiz gerekir.

Terminal veya komut istemcinizi açın ve aşağıdaki komutu çalıştırın:

```bash
pip install requests
```

Bu komut, `requests` kütüphanesini sisteminize kuracaktır. `json` kütüphanesi ise Python'ın yerleşik bir modülü olduğundan ayrıca yüklemenize gerek yoktur.

Adım 3: API İsteği Yapma ve JSON Yanıtını Alma

>

Şimdi API anahtarımız ve gerekli kütüphanemiz olduğuna göre, ilk HTTP isteklerimizi yapmaya başlayabiliriz. ExchangeRate-API, belirli bir temel para birimi üzerinden diğer para birimlerinin kurlarını sağlayan bir uç noktaya sahiptir.

Basit bir örnekle başlayalım: USD'nin diğer para birimlerine göre kurlarını çekelim.

```python
import requests
import json

Kendi API anahtarınızı buraya yapıştırın

API_KEY = "YOUR_API_KEY_HERE"
BASE_URL = f"https://v6.exchangerate-api.com/v6/{API_KEY}/latest/USD"

try:
response = requests.get(BASE_URL)
response.raise_for_status() # HTTP hatalarını kontrol et (örn. 404, 500)
data = response.json()

# API yanıtını kontrol edelim
print(json.dumps(data, indent=4))

except requests.exceptions.RequestException as e:
print(f"API isteği sırasında bir hata oluştu: {e}")
except json.JSONDecodeError:
print("API yanıtı JSON formatında değil.")
except Exception as e:
print(f"Beklenmeyen bir hata oluştu: {e}")

```

Bu kod bloğunda:
* `requests.get(BASE_URL)` ile belirtilen URL'ye bir GET isteği gönderiyoruz.
* `response.raise_for_status()` ile yanıtın başarılı (2xx) olup olmadığını kontrol ediyoruz. Değilse, bir HTTPError istisnası fırlatır.
* `response.json()` ile gelen JSON verisini bir Python sözlüğüne dönüştürüyoruz.
* Son olarak, `json.dumps(data, indent=4)` kullanarak veriyi okunabilir bir formatta ekrana yazdırıyoruz.
Daha kapsamlı bir HTTP istekleri yönetimi için [Python Requests kütüphanesi üzerine yazdığımız makalemize göz atın.](https://www.example.com/python-requests-rehberi)

Adım 4: Kullanıcı Girişlerini Alma ve Döviz Çevrimi Mantığı

>

Kullanıcıdan çevirmek istediği miktarı, kaynak para birimini ve hedef para birimini almamız gerekiyor. Daha sonra bu bilgileri API'den aldığımız kurlarla birleştirerek çevrimi yapacağız.

```python
def get_exchange_rates(api_key, base_currency):
"""Belirtilen temel para birimine göre döviz kurlarını çeker."""
url = f"https://v6.exchangerate-api.com/v6/{api_key}/latest/{base_currency.upper()}"
try:
response = requests.get(url)
response.raise_for_status()
data = response.json()
if data["result"] == "success":
return data["conversion_rates"]
else:
print(f"API hatası: {data.get('error-type', 'Bilinmeyen Hata')}")
return None
except requests.exceptions.RequestException as e:
print(f"API isteği sırasında hata: {e}")
return None
except json.JSONDecodeError:
print("API yanıtı JSON formatında değil.")
return None

def convert_currency(amount, source_currency, target_currency, api_key):
"""Döviz çevrimi işlemini gerçekleştirir."""
# Kaynak para biriminin kurlarını çekiyoruz
rates = get_exchange_rates(api_key, source_currency)

if not rates:
print(f"'{source_currency}' için döviz kurları alınamadı. Geçersiz para birimi olabilir mi?")
return None

if target_currency.upper() not in rates:
print(f"'{target_currency}' hedef para birimi bulunamadı. Geçersiz para birimi kodu olabilir mi?")
return None

# Çevrim mantığı: Miktar * Hedef_Kur
# API, temel para birimine göre kurları verdiği için doğrudan çarpabiliriz.
conversion_rate = rates[target_currency.upper()]
converted_amount = amount * conversion_rate
return converted_amount

Ana uygulama akışı

if __name__ == "__main__":
API_KEY = "YOUR_API_KEY_HERE" # Kendi API anahtarınızı buraya yapıştırın

while True:
try:
amount_str = input("Çevrilecek miktarı girin: ")
amount = float(amount_str)
if amount <= 0:
print("Miktar pozitif bir sayı olmalıdır.")
continue

source_currency = input("Kaynak para birimini girin (örn: USD, EUR, TRY): ").upper()
target_currency = input("Hedef para birimini girin (örn: GBP, JPY, CAD): ").upper()

if not source_currency.isalpha() or len(source_currency) != 3:
print("Geçersiz kaynak para birimi kodu. 3 harfli bir kod girin (örn: USD).")
continue
if not target_currency.isalpha() or len(target_currency) != 3:
print("Geçersiz hedef para birimi kodu. 3 harfli bir kod girin (örn: EUR).")
continue

converted_value = convert_currency(amount, source_currency, target_currency, API_KEY)

if converted_value is not None:
print(f"{amount:.2f} {source_currency} = {converted_value:.2f} {target_currency}")

another_conversion = input("Başka bir çevrim yapmak ister misiniz? (evet/hayır): ").lower()
if another_conversion != 'evet':
break

except ValueError:
print("Geçersiz miktar girişi. Lütfen bir sayı girin.")
except Exception as e:
print(f"Beklenmeyen bir hata oluştu: {e}")

print("Döviz çevirici kapatılıyor.")
```

Bu kod parçası, API'den döviz çevirici kurlarını çeken ve kullanıcıdan alınan girişlere göre çevrim yapan fonksiyonları içermektedir.

Kod Açıklaması:

>

* `get_exchange_rates(api_key, base_currency)` fonksiyonu: Bu fonksiyon, belirtilen `base_currency` (temel para birimi) için tüm dönüşüm kurlarını API'den çeker. Hata durumlarını kontrol eder ve başarılı olursa kurlar sözlüğünü döndürür.
* `convert_currency(amount, source_currency, target_currency, api_key)` fonksiyonu: Bu fonksiyon, asıl çevrim işlemini yapar. `source_currency` için kurları çeker ve `target_currency`'ye olan kuru kullanarak `amount` değerini çevirir. Geçersiz para birimi kodları için kontrol yapar.
* Ana Uygulama Akışı (`if __name__ == "__main__":`)
* Kullanıcıdan çevrilecek miktarı, kaynak ve hedef para birimlerini alır.
* Girişlerin sayısal olup olmadığını (`float()`) ve para birimi kodlarının doğru formatta olup olmadığını (`isalpha()` ve `len()`) kontrol eder.
* `convert_currency` fonksiyonunu çağırarak çevrimi gerçekleştirir.
* Sonucu kullanıcıya düzgün bir şekilde biçimlendirerek gösterir.
* Kullanıcıya başka bir çevrim yapmak isteyip istemediğini sorar.
* `try-except` blokları, olası `ValueError` (geçersiz sayı girişi) ve diğer genel hataları ele alarak uygulamanın çökmesini engeller.
JSON veri işleme hakkında daha fazla bilgi edinmek için [buradaki rehberimize bakın.](https://www.example.com/json-veri-isleme-rehberi)

Adım 5: Geliştirmeler ve İyileştirmeler

>

Oluşturduğumuz bu basit API istemcisi oldukça işlevsel olsa da, her zaman geliştirilebilecek yönler vardır:

* Daha Kapsamlı Hata Yönetimi: API'den gelen belirli hata türlerini daha detaylı işleyebiliriz (örn: "invalid-key", "inactive-account").
* Para Birimi Kodu Doğrulama: Kullanıcının girdiği para birimi kodunun gerçekten geçerli bir kod olup olmadığını API'ye bir liste sorgulayarak doğrulayabiliriz. (ExchangeRate-API'nin bunun için ayrı bir endpoint'i olabilir.)
* Veri Önbellekleme (Caching): Sık sık aynı kurlar isteniyorsa, API'ye her seferinde istek göndermek yerine, belirli bir süre boyunca kurları yerel olarak saklayabiliriz. Bu, API çağrısı limitlerini aşmayı önleyebilir ve yanıt süresini hızlandırabilir.
* Kullanıcı Arayüzü (GUI): Komut satırı yerine, Tkinter, PyQt veya Kivy gibi kütüphanelerle daha kullanıcı dostu bir grafik arayüz oluşturabiliriz.
* Geçmiş Kurları Görüntüleme: API'nin geçmiş kurlar sağlayan bir uç noktası varsa, belirli bir tarihteki kuru görüntüleme özelliği eklenebilir.

Sonuç

>

Bu rehberde, Python ve `requests` kütüphanesini kullanarak kendi basit döviz çevirici API istemcisi'nizi nasıl yazacağınızı adım adım öğrendiniz. API istemcisi oluşturma, dış veri çekme, HTTP istekleri yapma ve JSON verilerini ayrıştırma gibi temel programlama kavramlarını pratik bir örnekle pekiştirdiniz. Bu bilgi, gelecekteki projeleriniz için sağlam bir temel oluşturacaktır.

Kendi projelerinizi geliştirirken denemekten ve yeni şeyler öğrenmekten çekinmeyin. Bu basit uygulama, API'lerin gücünü ve gerçek zamanlı verilerle nasıl etkileşim kurabileceğinizi göstermektedir. İyi kodlamalar!