API Nedir ve Nasıl Kullanılır? Sıfırdan Basit Örnekle Anlatım

API, iki farklı yazılımın birbiriyle konuşmasını ve veri alışverişi yapmasını sağlayan bir köprüdür. Açılımı Application Programming Interface yani Uygulama Programlama Arayüzüdür. Bir uygulamanın, başka bir uygulamadan belirli bir kurala göre bilgi istemesini ve karşılığında yanıt almasını sağlar. Bu yazıda API'nin ne olduğunu günlük hayattan örneklerle, sıfırdan ve teknik jargona boğulmadan anlatıyorum.

API nedir? Restoran örneğiyle anlatım

API'yi anlamanın en kolay yolu bir restoran benzetmesidir. Siz masada oturursunuz, mutfağa doğrudan giremezsiniz. Aranızda bir garson vardır.

Siz garsona sipariş verirsiniz, garson bu siparişi mutfağa iletir, mutfak yemeği hazırlar ve garson yemeği size getirir. Burada garson API'dir. Siz uygulamasınız, mutfak ise verinin durduğu sunucudur.

Yani API, ne mutfağın nasıl çalıştığını bilmenizi ister ne de sizi mutfağa sokar. Sadece belirli bir menüden sipariş vermenize izin verir ve karşılığında sonucu getirir. Bir yazılımın diğerinin iç yapısını bilmeden ondan hizmet alması bu şekilde olur.

API neden kullanılır?

API'ler modern yazılımın temel yapı taşıdır. Neredeyse kullandığınız her uygulama arka planda bir veya birden fazla API ile konuşur.

• Bir hava durumu uygulaması, sıcaklık verisini meteoroloji sağlayıcısının API aracından çeker.
• Bir alışveriş sitesi, ödeme işlemini bankanın veya ödeme sağlayıcısının API aracıyla yapar.
• Bir sitedeki harita, konum verisini harita sağlayıcısının API aracından alır.
• Telefonunuzdaki uygulamalar, giriş işlemini başka bir hesabın API aracıyla yapabilir.

API sayesinde her yazılımcı her şeyi sıfırdan yazmak zorunda kalmaz. Hazır bir hizmeti API üzerinden çağırıp kendi uygulamasına ekleyebilir.

API nasıl çalışır? İstek ve yanıt mantığı

API iletişimi iki temel adımdan oluşur: istek ve yanıt. Uygulama bir istek gönderir, API bir yanıt döndürür.

İstek gönderirken bir adrese, yani endpoint'e başvurulur. Endpoint, API üzerindeki belirli bir hizmetin adresidir. Örneğin hava durumu için bir adres, döviz kuru için başka bir adres olur.

İstek genellikle HTTP protokolü üzerinden yapılır ve birkaç temel türü vardır:

• GET: Veri okumak, bilgi almak için kullanılır.
• POST: Yeni veri göndermek, kayıt oluşturmak için kullanılır.
• PUT: Var olan bir veriyi güncellemek için kullanılır.
• DELETE: Bir veriyi silmek için kullanılır.

API yanıtı çoğunlukla JSON adı verilen bir formatta gelir. JSON, hem insan hem makine tarafından kolay okunabilen, düzenli bir metin biçimidir.

JSON yanıtı neye benzer?

Bir hava durumu API aracına şehir sorduğunuzda size şuna benzer bir yanıt döner:

• sehir alanında şehrin adı
• sicaklik alanında derece bilgisi
• durum alanında güneşli veya yağmurlu gibi bir açıklama

Uygulamanız bu JSON yanıtını alır, içinden ihtiyacı olan alanı okur ve ekranda kullanıcıya gösterir. İşte telefonunuzdaki hava durumu ekranının arkasında bu basit döngü çalışır.

Basit bir API örneği adım adım

Diyelim ki döviz kuru gösteren küçük bir uygulama yapıyorsunuz. Süreç şu adımlardan oluşur:

1. Bir döviz API sağlayıcısı seçersiniz ve genellikle bir anahtar yani API key alırsınız.
2. Sağlayıcının verdiği endpoint adresine bir GET isteği gönderirsiniz.
3. API size güncel kurları JSON formatında yanıt olarak döner.
4. Uygulamanız bu yanıtı okuyup ekranda dolar ve euro kurunu gösterir.

Görüldüğü gibi verinin nereden geldiğini, sunucunun nasıl hesapladığını bilmenize gerek yok. Sadece doğru adrese doğru isteği gönderip gelen yanıtı kullanıyorsunuz.

API key nedir ve neden önemlidir?

Çoğu API, isteği kimin gönderdiğini bilmek ister. Bunun için size özel bir anahtar, yani API key verir. Bu anahtar, her isteğinizde kimliğinizi doğrular.

API key aynı zamanda kullanım limitini takip etmek için de kullanılır. Birçok ücretsiz API, günlük veya aylık belirli sayıda isteğe izin verir. Bu sınıra kota denir.

Önemli bir güvenlik notu: API key'inizi asla herkese açık kodda veya sitenin ön yüzünde paylaşmayın. Aksi halde başkaları sizin adınıza istek gönderip kotanızı tüketebilir.

Saha Notu: Kendi API servislerimi geliştirirken öğrendiklerim

Yıllardır kendi projelerim için hem API kullanıyorum hem de kendi API servislerimi yazıyorum. Nöbetçi eczane, döviz, hava durumu gibi servisleri tek bir portal altında topladığım bir yapı işletiyorum. Bu tecrübeyle net söyleyebileceğim birkaç şey var.

Birincisi, iyi bir API tutarlı olmalıdır. Bugün bir alan adı sicaklik iken yarın temperature olmamalı. Uygulamanız o alana göre kod yazdığı için isim değişince her şey kırılır.

İkincisi, kota yönetimi şart. Bir servisi herkese açtığınızda kötü niyetli olmasa bile aşırı istek gönderen kullanıcılar sunucuyu yorabilir. Ben bu yüzden her serviste API key ve istek limiti kullanıyorum.

Üçüncüsü, hata yanıtları da en az başarılı yanıt kadar önemlidir. Kullanıcı yanlış bir istek gönderdiğinde ona anlaşılır bir hata mesajı dönmek, kör bir hata ekranından çok daha iyidir. Saha tecrübem gösterdi ki API kullanan geliştiricilerin en çok takdir ettiği şey, açık ve net dokümantasyondur.

Sık Sorulan Sorular

API öğrenmek için programlama bilmek şart mı?

API kavramını anlamak için programlama şart değildir. Ancak bir API'yi gerçekten kullanmak, yani ona istek gönderip yanıtı işlemek için temel düzeyde bir programlama diline ihtiyaç duyarsınız.

REST API ile API arasında ne fark var?

API genel bir kavramdır. REST ise API tasarlarken izlenen yaygın bir kurallar bütünüdür. Bugün internette karşılaştığınız API'lerin büyük çoğunluğu REST mantığıyla çalışır.

Her API ücretli midir?

Hayır. Birçok API ücretsiz bir kullanım seviyesi sunar. Genellikle ücretsiz planda günlük istek sayısı sınırlıdır. Daha yüksek limit isteyenler için ücretli planlar bulunur.

JSON dışında başka yanıt formatı var mı?

Evet. Eskiden XML formatı yaygındı ve bazı sistemlerde hâlâ kullanılır. Ancak modern API'lerin çoğu, daha sade olduğu için JSON formatını tercih eder.

API key çalınırsa ne olur?

API key'iniz başkasının eline geçerse sizin adınıza istek gönderilebilir ve kotanız tükenebilir. Bu durumda yapılması gereken, sağlayıcı panelinden anahtarı iptal edip yeni bir anahtar oluşturmaktır.

Özet

API, iki yazılımın belirli kurallar çerçevesinde konuşmasını sağlayan bir köprüdür. Bir uygulama endpoint adresine istek gönderir, API çoğunlukla JSON formatında yanıt döner ve uygulama bu yanıtı kullanır. GET, POST, PUT ve DELETE gibi istek türleri temel işlemleri karşılar. API key ile kimlik doğrulanır ve kota takip edilir. Kısacası bugün kullandığınız hemen her uygulamanın arkasında, sessizce çalışan bir API vardır.