Python ile API Çağırma: Adım Adım Kılavuz

Giriş

Günümüzde yazılım geliştiricileri, farklı hizmetler ve uygulamalarla etkileşim kurabilmek için API’leri sıkça kullanıyor. API (Application Programming Interface), iki yazılım sistemi arasındaki etkileşimi sağlamaktadır. Python, basit ve anlaşılır sözdizimi sayesinde API’lerle çalışmayı oldukça kolaylaştırır. Bu yazıda, Python dilinde bir API’yi nasıl çağırabileceğinizi detaylı bir şekilde inceleyeceğiz.

Özellikle RESTful API’lerde, HTTP istekleri kullanılarak sunucu ile iletişim kurulur. GET, POST, PUT ve DELETE gibi HTTP yöntemlerini kullanarak verileri almak veya göndermek mümkün olmaktadır. Bu yazıda, temel API çağrılarını nasıl yapabileceğinizi örneklerle göstereceğiz.

Python ile API’yi Çağırmak için Gerekli Kütüphaneler

Python’da bir API’yi çağırmak için en yaygın kullanılan kütüphanelerden biri Requests‘dir. Bu kütüphane, HTTP istekleri yapmayı son derece basit hale getirir. Önce, kütüphaneyi projenize eklemeniz gerekiyor. Bunu yapmak için terminalden aşağıdaki komutu kullanabilirsiniz:

pip install requests

Bunun yanı sıra, JSON verilerini işleyebilmek için json modülünü de kullanacağız. JSON, API’lerden genellikle dönen veri formatıdır. Bu modülleri yükledikten sonra, API çağrılarımızı gerçekleştirebiliriz.

GET İsteği ile API’den Veri Alma

İlk örneğimizde, bir API’den veri almak için GET isteği yapacağız. Örneğin, bir hava durumu API’sinden hava durumunu almak için aşağıdaki adımları izleyebiliriz. Aşağıda basit bir örnek bulunmaktadır:

import requests

url = 'https://api.openweathermap.org/data/2.5/weather'
parameters = {'q': 'İstanbul', 'appid': 'API_KİLATANIZ'}

response = requests.get(url, params=parameters)

if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print('API çağrısında bir hata oluştu.')

Yukarıdaki kod parçacığında, hava durumu API’sine bir GET isteği gönderiyoruz. Gelen yanıtın durum kodunu kontrol ederek, isteğimizin başarılı olup olmadığını belirliyoruz. Başarılı bir yanıt alırsak, yanıtı JSON formatında alıyoruz ve verileri basıyoruz.

Yanıtın durum kodunu kontrol etmek, API çağrılarında iyi bir uygulama yönetimidir. Eğer hata alırsak, bunu uygun bir şekilde yakalayarak kullanıcıyı bilgilendirebiliriz.

POST İsteği ile API’ye Veri Gönderme

İkinci örneğimizde, bir API’ye veri göndermek için POST isteğini inceleyeceğiz. Örneğin, bir kullanıcı oluşturmak için bir API’ye veri gönderelim. Aşağıdaki kod örneği, nasıl yapıldığını göstermektedir:

import requests

url = 'https://jsonplaceholder.typicode.com/posts'

new_post = {
    'title': 'Yeni Gönderi',
    'body': 'Bu bir deneme gönderisidir.',
    'userId': 1
}

response = requests.post(url, json=new_post)

if response.status_code == 201:
    print('Yeni gönderi başarıyla oluşturuldu!')
    print(response.json())
else:
    print('Gönderi oluşturulurken bir hata oluştu.')

Burada, JSONPlaceholder API’sine bir POST isteği gönderiyoruz. Yeni bir gönderi oluşturmak amacıyla, gerekli verileri içeren bir sözlük oluşturuyoruz ve bu sözlüğü JSON formatında API’ye gönderiyoruz. Yanıt durum kodu 201 ise, gönderinin başarıyla oluşturulduğunu gösterir.

PUT ve DELETE İstekleri

API’ler ile etkileşimde bulunurken PUT ve DELETE isteklerini de kullanmamız gerekebilir. PUT isteği, mevcut bir veriyi güncellemek için; DELETE isteği ise veriyi silmek için kullanılır. Aşağıda PUT isteği ile veri güncelleme örneğine bakalım:

import requests

url = 'https://jsonplaceholder.typicode.com/posts/1'

updated_post = {
    'id': 1,
    'title': 'Güncellenmiş Başlık',
    'body': 'Bu bir güncellenmiş gönderidir.',
    'userId': 1
}

response = requests.put(url, json=updated_post)

if response.status_code == 200:
    print('Gönderi başarıyla güncellendi!')
    print(response.json())
else:
    print('Güncelleme sırasında hata oluştu.')

Yukarıdaki kod, ilk gönderinin güncellenmesi için PUT isteği yapıyor. İlgili gönderinin ID’sini belirtiyorsunuz ve güncellenmiş veriyi API’ye gönderiyorsunuz. Eğer başarılı olursa, güncellenen veriyi yazdırıyoruz.

DELETE isteği ise oldukça basit bir şekilde yapılır. Aşağıda bir gönderinin nasıl silineceği ile ilgili bir örnek bulunmaktadır:

import requests

url = 'https://jsonplaceholder.typicode.com/posts/1'

response = requests.delete(url)

if response.status_code == 200:
    print('Gönderi başarıyla silindi!')
else:
    print('Silme işlemi sırasında hata oluştu.')

API ile etkileşim sırasında her zaman bu durum kodlarını kontrol etmek iyi bir alışkanlıktır. Durum kodları, isteğinizin başarılı olup olmadığını anlamanıza yardımcı olur ve hata ayıklama sürecinde faydalıdır.

Hata Yönetimi ve İyileştirmeler

API çağrılarında karşılaşabileceğiniz bazı yaygın hatalar vardır. Bu hataları önlemek için, hataların iyi yönetilmesi önemlidir. Örneğin, ağ bağlantısı hataları, zaman aşımı hataları gibi durumlar olabilir. Aşağıda basit bir hata yönetimi örneği bulunmaktadır:

try:
    response = requests.get(url)
    response.raise_for_status()  # Bu, durum kodunu kontrol eder ve hatayı tetikler.
except requests.exceptions.HTTPError as errh:
    print('HTTP Hatası:', errh)
except requests.exceptions.ConnectionError as errc:
    print('Bağlantı Hatası:', errc)
except requests.exceptions.Timeout as errt:
    print('Zaman Aşımı Hatası:', errt)
except requests.exceptions.RequestException as err:
    print('Başka bir hata oluştu:', err)

Yukarıdaki kodda, gelen yanıtın durum kodunu kontrol etmek için raise_for_status() metodu kullanılıyor. Eğer bir hata varsa, duruma uygun bir mesaj iletiliyor. Bu şekilde, API çağrılarınızı daha güvenli hale getirebilirsiniz.

Ek olarak, bazı API’ler için kimlik doğrulama gereklidir. API anahtarınızı veya oturum bilgilerinizi başlıklara ekleyerek bu tür API’lere de erişim sağlayabilirsiniz. Örnek:

headers = {'Authorization': 'Bearer YOUR_API_KEY'}
response = requests.get(url, headers=headers)

Sonuç

Python ile API’leri çağırmak oldukça basit ve anlaşılırdır. HTTP isteklerini kullanarak uygulamanızda farklı hizmetlerle etkileşimde bulunabilirsiniz. Bu yazıda GET, POST, PUT ve DELETE gibi temel API çağrılarını nasıl yapacağınızı öğrendiniz. Ayrıca, hata yönetimi ve API kimlik doğrulaması gibi konulara da değindik.

Uygulamalarınızda bu bilgileri kullanarak, gerekli API çağrılarını gerçekleştirerek projelerinize yeni işlevsellikler katabilirsiniz. Unutmayın, her API’nin kendine özgü dokümantasyonu ve özellikleri vardır, bu yüzden kullanacağınız API’nin dökümantasyonunu dikkatlice okuyarak kullanmalısınız.

Umarım bu makale, Python ile API çağırma konusunda size faydalı olmuştur. Denemelerinizi yapmayı ve yeni API’lerle çalışmayı unutmayın!