API
Uygulama Programlama Arayüzü
Kısaca
API, bir yazılımın başka bir yazılımdan veri ya da işlem talep etmesini sağlayan, belgelenmiş ve öngörülebilir kurallar bütünüdür.
API nedir?
API bir sözleşmedir: bir yazılımın başkalarına hangi işlemleri sunduğunu ve bunların tam olarak nasıl çağrılacağını tanımlar. Çağıran taraf bu kurallara uydukça, içeride işin nasıl yapıldığını bilmeden işlevselliği kullanabilir.
Sık kullanılan bir benzetme, restoranlardaki garsondur. Mutfağa girmezsiniz; siparişinizi garsona verirsiniz, o da sonucu size getirir. Web'de sipariş genellikle bir HTTP isteği, sonuç ise çoğunlukla JSON biçiminde bir veridir.
API'ler yalnızca web servisleriyle sınırlı değildir. İşletim sisteminin dosya okumak için sunduğu fonksiyonlar ya da bir kütüphanenin herkese açık metotları da birer API'dir.
Bir bakışta
Önemli noktalar
- API, iki yazılımın birbiriyle nasıl iletişim kuracağını tanımlar.
- Çağıranların iç uygulamayı bilmesine gerek yoktur.
- Web API'leri genellikle HTTP üzerinden çalışır ve JSON döndürür.
- Yalnızca web servisleri değil, kütüphaneler ve işletim sistemleri de API sunar.
Örnek
// Ask the API for a user's details
const response = await fetch("https://api.example.com/users/42");
const user = await response.json();
console.log(user.name);Sık sorulan sorular
API ile REST API aynı şey midir?
Hayır. API genel kavramdır; REST API ise HTTP üzerine kurulu ve REST ilkelerini izleyen bir API stilidir.
API anahtarı (API key) nedir?
API anahtarı, isteklerle birlikte gönderilen gizli bir değerdir; API bu sayede isteği yapanı tanır ve erişimi denetler ya da sınırlar.
Sık karşılaştırılanlar
İlgili sayfalar
- REST APIBackend ve API'ler, s. 38REST API, verileri URL'lerle tanımlanan kaynaklar olarak sunan ve istemcilerin onları standart HTTP metotlarıyla okuyup değiştirmesini sağlayan web API'sidir.
- GraphQLBackend ve API'ler, s. 18GraphQL, istemcilerin tam ihtiyaç duyduğu veriyi, çoğunlukla tek bir endpoint üzerinden tek istekte istemesini sağlayan API sorgu dili ve çalışma zamanıdır.
- EndpointBackend ve API'ler, s. 11Endpoint, bir API'nin belirli bir kaynak veya eylem için istek alıp yanıt döndürdüğü, bir HTTP metoduyla birlikte kullanılan belirli bir URL'dir.
- JSONBackend ve API'ler, s. 24JSON, yapılandırılmış veriyi anahtar-değer çiftleri ve listelerle saklayıp aktarmaya yarayan, insanın da makinenin de okuyabildiği hafif bir metin biçimidir.
- HTTPWeb Geliştirme, s. 20HTTP, tarayıcıların, uygulamaların ve sunucuların basit bir istek-yanıt döngüsüyle web sayfaları ve veri alışverişi yapmasını sağlayan protokoldür.
- API GatewayBackend ve API'ler, s. 3API gateway, bir grup backend servisinin önünde duran ve API isteklerini alan, kontrol eden ve yönlendiren tek giriş noktası görevi gören bir sunucudur.
- SDKProgramlamanın Temelleri, s. 48SDK (yazılım geliştirme kiti), belirli bir platform veya servis için geliştirme yapmaya yarayan araç, kütüphane, dokümantasyon ve örneklerden oluşan pakettir.
Bu sayfada bir hata ya da eksik mi gördünüz?Düzeltme önerin