Ana içeriğe geç

API

Uygulama Programlama Arayüzü

Güncellendi 1 dk okuma

Bu sayfayı paylaşın

Bağlantıyı gönderin, tanımı bağlantısıyla birlikte alıntılayın ya da kendi sitenizde bir kart olarak gösterin.

https://softwaredictionary.org/tr/terimler/api

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?

  1. Kodunuz bir istek gönderir

    API'nin belgelediği bir adresi çağırır ve ne istediğini söyler.

    GET /v1/weather?city=Paris
  2. API isteği kontrol eder

    Anahtarınızı ve isteğin kurallarına uyup uymadığını kontrol eder.

    X-API-Key: 4f9a…
  3. 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.

  4. 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

Uygulamanız, sunduğu işlemleri listeleyen bir API'ye GET /users/42 isteğini gönderir; servisin kodu ve veritabanı API'nin arkasında gizli kalır ve API { "name": "Ada" } JSON yanıtını geri döndürür.Servisin içiGET /users/42{ "name": "Ada" }Uygulamanızçağıran tarafAPIbelgelenmiş işlemlerGET /users/:idPOST /ordersDELETE /orders/:idKodVeritabanıçağıranın gördüğüçağırandan gizli
Çağıran taraf yalnızca belgelenmiş işlemlere uyar; servisin işi içeride nasıl yaptığı gizli kalır ve rahatça değişebilir.

Ö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

Bir web API'sinden veri çekmekjavascript
// 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

Ü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.

Önce e-postayla onaylarsınız; tek tıkla çıkabilirsiniz. Gizlilik

Bu haftanın sayısına göz at

Bu sayfa hakkında

Sayfa geçmişi

  1. "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?

Daha fazla

Ayarlar