API Nedir, Ne İşe Yarar? Basit Anlatım ve Örnekler

Hava durumu uygulaması bir başka servisten sıcaklık verisini nasıl alıyor? E-ticaret siteniz kargo firmasının sistemine sipariş bilgisini nasıl gönderiyor? İkisinin de cevabı aynı: API. Yazılım dünyasının en çok duyulan ama en az net anlatılan kavramlarından biri.

API Nedir?​

API (Application Programming Interface), iki yazılımın birbiriyle konuşmasını sağlayan kurallar bütünüdür. Kısaca "yazılımlar arası arayüz" diyebiliriz. Bir uygulama, kendisindeki veriyi veya yeteneği dışarıya açmak istediğinde bir API tanımlar; diğer uygulamalar bu tanıma uygun istek (request) gönderip yanıt (response) alır.

Bunu restoran benzetmesiyle anlatmak en kolayıdır. Mutfak üretimi yapar (veritabanı ve iş mantığı), garson ise sizin adınıza siparişi götürüp yemeği getirir. Garson olmadan mutfağa girip kendi yemeğinizi almanız beklenmez. API işte bu garsondur: siz ne istediğinizi söylersiniz, sistem arka planda ne olduğunu bilmeden sonucu alırsınız.

Bugün yaygın olan yaklaşım REST API'dir. İstekler HTTP metotlarıyla yapılır: GET veri okur, POST yeni kayıt oluşturur, PUT güncelller, DELETE siler. Veri biçimi genellikle JSON'dur. Yanıtların yanında durum kodları döner: 200 başarı, 401 kimlik doğrulama hatası, 404 bulunamadı, 500 sunucu hatası. Bu kodları bilmek, entegrasyon hatalarını çözerken en büyük yardımcıdır.

API Nasıl Kullanılır? Adım Adım​

1. Dokümantasyonu bulun. Kullanacağınız servisin geliştirici sayfasındaki API dokümanını açın. Uç nokta (endpoint) adresi, gereken parametreler ve örnek istekler burada yazar.
2. Erişim anahtarı (API key) alın. Çoğu servis hesap panelinden bir anahtar üretmenizi ister. Bu anahtar şifre gibidir; kod içine gömülmez, ortam değişkeninde saklanır.
3. Kimlik doğrulamayı öğrenin. Anahtar ya istek başlığında (Authorization) ya da parametre olarak gönderilir. Yanlış yöntem 401 hatası verir.
4. İlk isteği test edin. Tek satırlık bir araçla deneyin: curl -H "Authorization: Bearer ANAHTARINIZ" "https://api.servis.com/v1/urunler?limit=5"
5. Yanıtı okuyun. Gelen JSON içinde hangi alanların olduğunu inceleyin; sonraki istekleri bu yapıya göre kurun.
6. Hata yönetimini ekleyin. 429 (çok fazla istek) ve 5xx yanıtlarında tekrar deneme (retry) mantığı yazın; aksi hâlde sistem geçici kesintide çöker.
7. Hız limitini (rate limit) kontrol edin. Servis dakikada kaç istek kabul ediyor öğrenin ve toplu işlemleri buna göre sıraya koyun.
8. Üretime almadan önce loglayın. Hangi isteğin ne zaman ve hangi yanıtı verdiğini kaydetmek, entegrasyon sorunlarını dakikalar içinde bulmanızı sağlar.

Nerede Karşımıza Çıkar, Kimler Kullanır?​

API hayatın her yerinde: harita uygulamasının konum verisi, ödeme altyapılarının kart doğrulaması, e-ticaret ile kargo firması arasındaki takip bilgisi, hava durumu widget'ı, sosyal medya girişi, yapay zeka servisleri. Bir site "Google ile giriş" sunuyorsa orada da bir API çalışıyordur.

Geliştiriciler, test mühendisleri, veri analistleri ve ürün yöneticileri API'yi günlük iş akışında kullanır. Ancak API bilgisi sadece kod yazanlara gerekmez: bir pazarlamacı reklam platformunun API'siyle rapor verisini otomatik çekebilir, bir muhasebeci e-fatura servisinin API'siyle kayıtları eşleştirebilir.

Sık Yapılan Hatalar

• API anahtarını kaynak koduna yazıp paylaşmak; anahtar sızarsa başkası sizin kotanızla işlem yapar.
• Dokümantasyonu okumadan tahminle istek atmak; saatler kaybettirir, çoğu zaman sorun tek bir parametre adıdır.
• Hız limitini aşacak şekilde döngü kurmak; hesap geçici olarak kilitlenir.
• Hata kodlarını yok saymak; 200 dışındaki yanıtları loglamayan sistem sorunu görünmez hâle getirir.

Sonuç
API, yazılımların birbirine veri ve yetenek aktarmasını sağlayan standart bir sözleşmedir. Öğrenmenin en hızlı yolu, ücretsiz bir servisin dokümantasyonunu açıp tek bir GET isteğiyle veri çekmek ve dönen JSON'u incelemektir. Bu tek deney, terimlerin çoğunu anında anlamlı hâle getirir.

API'nin temel işlevi, iki yazılımın iletişim kurmasını sağlamak. Hava durumu uygulaması ile e-ticaret sitesi örneği oldukça açıklayıcı; her ikisi de dış kaynaklardan veri alıyor veya veri iletiyor. REST API, yaygın bir yöntem ve HTTP metotları ile çalıştığı için bu konuda yeterince bilgi sahibi olmak önemli. Öte yandan, hata kodlarına dikkat etmekte özellikle fayda var; bunlar entegrasyon sürecindeki sorunları çözmekte büyük rol oynar. Fakat sık yapılan hatalar da göz önünde bulundurulmalı.