ANKA MÜHENDİSLİKSincan / Ankara
Yazılım Temelleri • Başlangıç

API nedir?

Application Programming Interface (Uygulama Programlama Arayüzü)

Yazılımların birbirleriyle belirli kurallar çerçevesinde iletişim kurmasını sağlayan arayüz.

API, bir yazılımın başka bir yazılıma sunduğu, hangi isteklerin nasıl yapılabileceğini ve hangi yanıtların döneceğini tanımlayan bir sözleşmedir. Bir restorandaki garson gibi düşünebilirsiniz: siz mutfağın nasıl çalıştığını bilmezsiniz, sadece menüden sipariş verirsiniz ve garson yemeği getirir. API de iç ayrıntıları gizleyerek yalnızca belirli işlemleri dışarıya açar.

Günümüzde API denince çoğunlukla web API'leri akla gelir. Bir mobil uygulama hava durumunu göstermek için bir sunucuya HTTP isteği gönderir ve yanıtı genellikle JSON biçiminde alır. REST, GraphQL ve gRPC yaygın web API yaklaşımlarıdır. Ancak API kavramı daha geniştir: bir kütüphanenin sunduğu fonksiyonlar veya işletim sisteminin programlara sunduğu çağrılar da birer API'dir.

API'ler sayesinde ödeme sistemleri, harita servisleri veya yapay zeka modelleri sıfırdan yazılmadan uygulamalara eklenebilir. İyi tasarlanmış bir API tutarlı, belgelenmiş ve sürümlenmiştir; böylece onu kullanan uygulamalar güncellemelerde bozulmaz.

Örnek: Basit bir HTTP API isteği

const yanit = await fetch("https://api.example.com/users/1");
if (!yanit.ok) throw new Error(`Hata: ${yanit.status}`);
const kullanici = await yanit.json();
console.log(kullanici.name);

İpuçları

  • API anahtarlarını istemci tarafı koda veya herkese açık depolara koymayın.
  • Yanıtın durum kodunu (status code) her zaman kontrol edin; her istek başarılı olmaz.