API nedir? Uygulamalar birbirleriyle nasıl konuşur?

API, iki yazılımın birbirine veri sorup cevap almasını sağlayan kurallar bütünüdür. Nasıl çalıştığı, türleri ve günlük hayattan örnekler.

Bir yemek siparişi uygulaması açıldığında, ekranda tek bir uygulama varmış gibi görünür. Oysa arka planda birçok farklı sistem çalışır: Restoranın konumu bir harita servisinden gelir, ödeme bir bankanın altyapısından geçer, sipariş onayı bir SMS servisiyle gönderilir. Bu sistemlerin hepsi farklı şirketlere ait, farklı dillerle yazılmış yazılımlardır. Birbirleriyle API'ler sayesinde konuşurlar.

API nedir?

API (Application Programming Interface, Türkçesiyle Uygulama Programlama Arayüzü), bir yazılımın başka yazılımlara "bana şu şekilde sorarsan sana şu cevabı veririm" dediği kurallar bütünüdür.

Bir uygulama, başka bir sistemin içinde nasıl çalıştığını bilmek zorunda değildir. Sadece o sistemin API'sine doğru biçimde soru sorar ve cevabı alır. Hava durumu uygulaması meteoroloji verilerinin nasıl hesaplandığını bilmez; API'ye "İstanbul'da hava nasıl?" diye sorar ve gelen cevabı ekranda gösterir.

Restoran benzetmesi

API'yi anlatmak için en sık kullanılan örnek restorandır:

- Müşteri bilgi isteyen uygulamadır (istemci).
- Mutfak veriyi tutan ve işleyen sistemdir (sunucu).
- Garson API'dir.

Müşteri mutfağa girip yemeği kendisi yapmaz. Menüden seçer, siparişi garsona verir. Garson siparişi mutfağa iletir ve hazır olan yemeği masaya getirir. Menüde olmayan bir şey istenirse garson "bu yok" der. API'nin "menüsü" de hangi sorulara cevap verildiğini gösteren belgelerdir; buna API dokümantasyonu denir.

Bir API isteği neye benzer?

Uygulamalar API'ye genelde internet üzerinden, belirli bir adrese istek gönderir. Bu adrese endpoint denir. Örneğin bir mağazanın sipariş durumunu soran istek şöyle olabilir:

```
GET https://api.ornekmagaza.com/siparisler/1042
```

Sunucu da cevabı çoğunlukla JSON adı verilen, hem insanların hem yazılımların okuyabildiği bir biçimde gönderir:

```
{
"siparis_no": 1042,
"durum": "kargoda",
"kargo_firmasi": "Örnek Kargo",
"tahmini_teslim": "2026-10-25"
}
```

Uygulama bu cevabı alır ve kullanıcıya "Siparişiniz kargoda, 25 Ekim'de teslim edilecek" şeklinde gösterir.

İstek türleri

API'lere gönderilen isteklerin ne yapmak istediği, kullanılan yönteme göre anlaşılır:

- GET: Veri okumak. Örneğin bir ürünün fiyatını öğrenmek.
- POST: Yeni bir kayıt oluşturmak. Örneğin yeni bir sipariş vermek.
- PUT / PATCH: Var olan bir kaydı güncellemek. Örneğin teslimat adresini değiştirmek.
- DELETE: Bir kaydı silmek.

Cevap kodları

Sunucu her cevapla birlikte bir durum kodu da gönderir. En bilinenleri şunlardır:

- 200: İstek başarılı.
- 401 / 403: Yetki yok; giriş yapılmamış ya da izin verilmemiş.
- 404: İstenen kayıt bulunamadı. Tarayıcıda görülen "404 sayfa bulunamadı" hatası da buradan gelir.
- 500: Sunucu tarafında bir hata oluştu.

API türleri

- REST: Bugün en yaygın kullanılan yaklaşımdır. Web adresleri ve yukarıdaki GET, POST gibi yöntemlerle çalışır. Çoğu zaman JSON kullanır.
- SOAP: Daha eski ve daha katı kurallı bir standarttır. Bazı bankacılık ve kamu sistemlerinde hâlâ kullanılır. Veriyi XML biçiminde taşır.
- GraphQL: İstemcinin tam olarak hangi alanları istediğini belirttiği bir yaklaşımdır. Gereksiz veri taşınmaz; özellikle mobil uygulamalarda tercih edilir.
- Webhook: Diğerlerinden farklı olarak, istemci sormadan sunucu haber verir. Örneğin bir ödeme tamamlandığında ödeme sistemi, mağazanın sistemine "ödeme alındı" bildirimini kendiliğinden gönderir.

Günlük hayattan API örnekleri

- "Google ile giriş yap" düğmesi: Site şifrenizi görmez; Google'ın API'si kimliğinizi doğrular ve siteye yalnızca izin verdiğiniz bilgileri iletir.
- Online ödeme: E-ticaret siteleri kart bilgilerini kendileri işlemez, bir ödeme kuruluşunun API'sine gönderir.
- Kargo takibi: Mağaza, kargo firmasının API'sinden paketin durumunu alıp kendi sayfasında gösterir.
- Döviz kurları: Birçok muhasebe programı güncel kurları bir kur servisinin API'sinden otomatik olarak çeker.
- Harita gösterimi: Sitelerdeki "bizi haritada bulun" bölümleri genelde bir harita servisinin API'siyle çalışır.

API güvenliği

API'ler bir sistemin içine açılan kapılar olduğu için korunmaları gerekir. Bunun için kullanılan başlıca yöntemler şunlardır:

- API anahtarı: İsteği gönderen uygulamayı tanımlayan özel bir koddur. Gizli anahtarlar uygulamanın kodunda açıkça paylaşılmamalı, sunucu tarafında saklanmalıdır.
- Token ve OAuth: Kullanıcının şifresini paylaşmadan sınırlı ve süreli erişim izni vermeyi sağlar. "Google ile giriş yap" bu yöntemle çalışır.
- İstek sınırı (rate limit): Aynı kaynaktan kısa sürede çok fazla istek gelmesini engeller; kötüye kullanıma ve aşırı yüke karşı korur.
- HTTPS: Gidip gelen verinin yolda okunmasını önler.

İşletmeler için API ne anlama gelir?

Bir yazılım seçerken ya da yaptırırken "API'si var mı?" sorusu düşündüğünden daha önemlidir. API'si olan bir sistem, ileride başka araçlarla bağlanabilir: e-ticaret sitesi muhasebe programıyla, muhasebe programı bankayla, stok sistemi kargo firmasıyla konuşabilir. API'si olmayan bir sistemde ise bu bağlantılar çoğu zaman elle yapılır; veriler kopyalanıp yapıştırılır, hatalar da çoğalır.