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.
Nasıl çalışır?
Kodunuz bir istek gönderir
API'nin belgelediği bir adresi çağırır ve ne istediğini söyler.
GET /v1/weather?city=ParisAPI isteği kontrol eder
Anahtarınızı ve isteğin kurallarına uyup uymadığını kontrol eder.
X-API-Key: 4f9a…Sağlayıcı işi yapar
API'nin arkasında sağlayıcının kendi kodu ve veritabanları cevabı bulur. Siz bunları hiç görmezsiniz.
Cevabı alırsınız
Cevap anlaşılan biçimde, çoğunlukla JSON olarak, nasıl sonuçlandığını söyleyen bir durum koduyla gelir.
200 OK {"temp": 18}
Sık yanlış anlaşılan
Sanılan: API bir web sitesi ya da sunucudur.
Aslında: API bir sözleşmedir: bir yazılımın kabul ettiği istekler ve verdiği cevaplar. Çoğu zaman bir web servisidir, ama bir kütüphane ya da işletim sistemi de kodunuza bir API sunar.
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.
İlgili sayfalar
- API vs SDKAPI, bir servisin sunduğu istekler ya da fonksiyonlardır; SDK ise genellikle bu API üzerine kurulan ve onu bir dilde kullanmayı kolaylaştıran araç takımıdır.
- API vs WebhookAPI'de uygulamanız veri istediği an bir istek gönderir; webhook'ta ise bir olay olur olmaz başka bir servis sizin URL'inize bir istek gönderir.
- MCP vs APIAPI, programların bir servisi kullandığı arayüzdür. MCP ise yapay zekâ uygulamalarını araç ve veriye bağlayan açık standarttır; sunucuları çoğu zaman API sarar.
- REST APIBackend ve API'ler, s. 41REST 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. 20GraphQL, 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. 13Endpoint, 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. 26JSON, 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. 24HTTP, 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. 53SDK (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.
Ücretsiz · haftada bir
Yazılım ve yapay zekâ, haftada bir, sade bir dille
Haftanın haberleri, her terimi açıklanmış hâlde; üstüne öğrenecek bir terim ve kısa bir quiz. Okuması iki dakika.
Bu haftanın sayısına göz atBu sayfa hakkında
Sayfa geçmişi
"Nasıl çalışır?" eklendi: istekten cevaba bir API çağrısı ve API'nin aslında ne olduğu.
Bu sayfanın söylediğini değiştiren düzenlemeler. Yazım düzeltmeleri listelenmez.
Bu sayfada bir hata ya da eksik mi gördünüz?Düzeltme önerin
Sayfalar nasıl hazırlanıyor?