Python ile API entegrasyonu: veriyi çekmek ve sistemleri bağlamak

API entegrasyonu ne demektir, Python neden uygundur?

API, bir yazılımın başka bir yazılıma belirli kurallarla istek gönderip yanıt almasını sağlayan arayüzdür. Entegrasyon, birden çok sistemin bu arayüzler üzerinden veri alıp vermesi, böylece elle kopyala-yapıştır işinin ortadan kalkmasıdır. Örneğin bir e-ticaret sitesindeki siparişleri muhasebe yazılımına aktarmak ya da bir CRM'deki müşteri kaydını e-posta platformuna göndermek böyle çözülür.

Python bu iş için yaygın seçilir: okunaklı sözdizimi, HTTP istekleri için olgun kütüphaneleri, JSON verisini doğal biçimde sözlük ve listeye çevirmesi ve veri tabloları, dosyalar ve e-posta gibi sonraki adımlar için hazır araçları vardır. Küçük bir betikle başlayıp zamanla düzenli çalışan bir entegrasyona dönüştürmek mümkündür.

Temel kavramlar: istek, yanıt, yöntem, durum kodu

REST tarzı bir API ile konuşmak için şu parçaları bilmek yeterlidir:

• Uç nokta (endpoint): isteğin gönderildiği adres; genellikle bir kaynağı temsil eder, örneğin siparişler ya da müşteriler.
• HTTP yöntemi: veriyi okumak için GET, yeni kayıt oluşturmak için POST, güncellemek için PUT ya da PATCH, silmek için DELETE kullanılır.
• Başlıklar (headers): kimlik bilgisi ve içerik türü gibi ek bilgileri taşır.
• Parametreler: filtreleme, sayfalama ve sıralama gibi seçenekleri iletir.
• Gövde: gönderilen ya da alınan veri, çoğunlukla JSON biçimindedir.
• Durum kodu: isteğin başarılı olup olmadığını söyler. Başarılı yanıtlar, istemci hataları ve sunucu hataları ayrı gruplarda gelir; hangi grupta olduğunu anlamak hata yönetiminin temelidir.

Python'da bu iş için en çok kullanılan araç requests kütüphanesidir; daha gelişmiş eşzamansız ihtiyaçlar için başka kütüphaneler de vardır.

Adım adım: ilk entegrasyonu kurmak

Sağlam bir entegrasyon genellikle şu sırayla kurulur:

• Dokümantasyonu okuyun: uç noktalar, kimlik doğrulama yöntemi, istek sınırları ve yanıt biçimi API'nin resmî belgesinde yazılıdır.
• Önce elle deneyin: bir API istemci aracıyla ya da kısa bir betikle tek bir istek gönderip yanıtı inceleyin.
• Kimlik doğrulamayı ekleyin: anahtar ya da erişim jetonunu başlıkta gönderin.
• Yanıtı işleyin: JSON'u sözlüğe çevirin, ihtiyacınız olan alanları seçin, eksik ya da boş alanlara hazırlıklı olun.
• Sayfalamayı ele alın: sonuçlar parça parça geliyorsa döngü ile tüm sayfaları çekin.
• Hedef sisteme yazın: dönüştürülen veriyi diğer sistemin API'sine gönderin ya da dosya, veri tablosu veya veritabanına kaydedin.
• Zamanlayın ve izleyin: betiği düzenli çalıştırın, çıktıyı günlüğe yazın.

Örnek senaryo: siparişleri muhasebe sistemine aktarmak

Örneğin bir mağaza, günlük siparişlerini e-ticaret platformunun API'sinden çekip muhasebe yazılımına fatura taslağı olarak göndermek istiyor. Betik önce son çalışmadan bu yana oluşan siparişleri tarih filtresiyle ister. Gelen her siparişi muhasebe sisteminin beklediği alanlara dönüştürür: müşteri adı, vergi bilgisi, kalemler, tutarlar.

Betik, daha önce aktarılmış siparişleri tekrar göndermemek için sipariş numaralarını bir kayıtta tutar. Muhasebe sistemi hata dönerse (örneğin zorunlu bir alan eksikse) o siparişi hatalı listesine alır ve işleme devam eder. Gün sonunda başarılı ve başarısız kayıtların özeti ilgili kişiye e-postayla gider. Bu yapı, tek bir hatalı kaydın tüm aktarımı durdurmasını engeller.

Kimlik doğrulama ve gizli bilgilerin korunması

API'ler genellikle bir anahtar, jeton ya da OAuth tabanlı yetkilendirme ister. Bu bilgiler kodun içine yazılmaz; ortam değişkenlerinde ya da bir gizli bilgi yönetim aracında tutulur ve kod deposuna gönderilmez. Kod bir paylaşım ortamına çıktığında anahtar da sızmış olur.

Erişim jetonları süreli olabilir; süresi dolduğunda yenileme adımı kodlanmalıdır. API sağlayıcısının sunduğu en dar yetkiyi kullanın: yalnızca okuma gerekiyorsa yazma yetkisi olan bir anahtar istemeyin. Kişisel veri taşıyan yanıtları günlüğe olduğu gibi yazmamaya özen gösterin ve veri paylaşımında KVKK gibi yükümlülükleri hesaba katın.

Hata yönetimi, sınırlar ve yeniden deneme

Gerçek hayatta API çağrıları başarısız olur: ağ kesilir, sunucu yavaşlar, sınır aşılır, veri beklenmedik biçimde gelir. Üretim kalitesindeki betik her isteğe bir zaman aşımı süresi koyar; aksi hâlde cevap gelmeyen bir istek betiği süresiz bekletebilir. Başarısız yanıtlar kontrol edilir ve anlamlı bir hata mesajıyla kaydedilir.

Geçici hatalarda (sunucu meşgul, istek sınırı aşıldı) beklemeli yeniden deneme mantıklıdır: her denemede bekleme süresi uzatılır. API'lerin çoğu belirli bir zaman diliminde yapılabilecek istek sayısını sınırlar; sayfalama döngüsünde bu sınıra çarpmamak için istekler arasına bekleme eklenir. Kalıcı hatalarda ise (yetki yok, kaynak bulunamadı) yeniden denemek yerine durup uyarı vermek doğrudur.

Sık yapılan hatalar

Dokümantasyonu okumadan denemeye başlamak, yanlış yöntem ya da eksik parametre yüzünden zaman kaybettirir. Yanıtın her zaman aynı yapıda geleceğini varsaymak da risklidir; alan boş ya da hiç olmayabilir, bu yüzden sözlükten değer okurken eksik anahtarı hesaba katmak gerekir.

Sayfalamayı atlamak, verinin yalnızca ilk parçasının işlenmesine yol açar ve genellikle fark edilmez. Aynı kaydın tekrar gönderilmesi (idempotent olmayan çağrılar) mükerrer fatura ya da sipariş doğurabilir; bu yüzden gönderilenleri kaydetmek ve mümkünse API'nin tekrarlı istekleri tanıyan mekanizmasını kullanmak gerekir. Son olarak, canlı sisteme geçmeden önce varsa test ortamında denemek, geri alması zor hataları önler.

Bu beceriyi Mindset programlarında nerede çalışırsınız?

Python Otomasyon ile Verimlilik programının modül başlıkları arasında API Entegrasyonu ve Son Otomasyon Projesi ile zamanlanmış görevler ve süreç yönetimi bulunur. Aynı programda dosya ve klasör yönetimi, Excel, PowerPoint ve rapor üretimi ile e-posta otomasyonu da yer alır; böylece API'den çekilen verinin rapora ve bildirime dönüştüğü uçtan uca bir akış kurulabilir.

Python ile Robotic Process Automation (RPA) Eğitimi ise Python temellerinden başlayarak belge, veritabanı, CSV ve JSON otomasyonu, web kazıma ve otomatik e-postalar konularını kapsar. Operasyon, finans ve satış desteği ekiplerinde sistemler arası elle veri taşıyan çalışanlar için uygun bir zemindir.