Wesloo
Tüm konularKonular

Uygulamalar ve yazılımlar

API nedir örnekleri ve temel kavramlar

Kısa cevap

API, iki yazılımın veri ve işlev paylaşması için kullandığı kurallar bütünüdür. API anahtarı ise isteği yapan uygulamayı tanıtan ve erişimi sınırlayan bir kimlik bilgisidir. Bu sayfa temel kavramları, örnekleri ve güvenlik notlarını açıklar.

Ana maddeler

  • API, uygulamalar arasında veri ve işlev alışverişi için ortak kurallar tanımlar.
  • API anahtarı, isteği yapan uygulamayı veya projeyi tanıtan benzersiz bir kodtur.
  • Anahtar doğruysa erişim verilir; yanlışsa istek reddedilir.
  • OAuth, JWT ve token tabanlı yöntemler farklı kimlik doğrulama ihtiyaçlarına hizmet eder.
  • API'ler yalnızca gerekli veriyi paylaşır ve iç sistem ayrıntılarını gizler.

API nedir örnekleri ararken iki programın nasıl konuştuğu sorusu öne çıkar. API, uygulamaların veri ve işlev paylaşması için kullandığı kurallar bütünüdür. Bir hava durumu servisi sıcaklık verisini bir uç nokta üzerinden sunar; istemci uygulama bu uç noktaya istek gönderir ve yapılandırılmış bir yanıt alır. Bu sayede her uygulama kendi iç yapısını gizleyebilir.

API nedir?

API, application programming interface kavramının kısaltmasıdır ve yazılımların birbirine kontrollü erişim sağlamasını düzenler. Bir uygulama sahibi, veri ve işlevlerini yalnızca gerekli ölçüde açar; diğer uygulamalar bu açık kapıdan istekte bulunur. Böylece iç sistem ayrıntıları gizli kalır ve güvenlik korunur.

API'ler kurum içinde de kullanılır. İnsan kaynakları sistemi bordro verisini finans sistemine aktarabilir; iki sistem aynı veritabanını paylaşmak zorunda kalmaz. Dış dünyaya açılan API'ler ise iş ortaklarına veya üçüncü taraf geliştiricilere hizmet sunar.

API nasıl çalışır?

Çalışma akışı istek ve yanıt üzerine kuruludur. İstemci bir adres (uç nokta) belirler, gerekli parametreleri ekler ve isteği gönderir. Sunucu isteği alır, kimlik bilgisini kontrol eder, işlemi yapar ve sonucu döndürür. Yanıt genellikle JSON gibi yapılandırılmış bir biçimde gelir.

YöntemNe yapar
GETVeri okur
POSTYeni kayıt oluşturur
PUTMevcut kaydı günceller
DELETEKaydı siler

Bu yöntemler REST tarzı API'lerde sık görülür. Her istek durum kodu ile birlikte döner; 200 başarılı, 401 yetkisiz, 404 bulunamadı gibi kodlar sonucu özetler. Geliştirici bu kodlara göre hata yönetimi yapar.

API nedir örnekleri: günlük kullanım

API'ler günlük uygulamaların arka planında çalışır. Aşağıdaki örnekler tipik kullanım alanlarını gösterir.

  • Hava durumu uygulaması, bir servisten konum bazlı tahmin verisi alır.
  • E-ticaret sitesi, ödeme sağlayıcısına istek gönderir; kart verisi doğrudan siteye gelmez.
  • Harita kullanan bir uygulama, rota ve mesafe bilgisini harita servisinden çeker.
  • Sosyal medya paylaşımı yapan bir uygulama, kullanıcı adına işlem yapmak için izin ister.
  • Kurumsal bir sistem, bordro verisini finans sistemine aktarır.

Bu örneklerde ortak nokta şudur: bir taraf veri veya işlev sunar, diğer taraf kontrollü biçimde kullanır. Açık kaynak yazılım konusu açık kaynak kodlu yazılım nedir ve nasıl çalışır sayfasında ayrıca anlatılır.

API anahtarı nedir?

API anahtarı, bir uygulama veya kullanıcıyı tanıtan benzersiz bir kod dizisidir. Sağlayıcı bu kodu hesabınıza veya projenize bağlar. İstek geldiğinde kod kontrol edilir; doğruysa erişim verilir, yanlışsa istek reddedilir.

Anahtar hem kimlik bilgisi hem de basit bir parola gibi çalışır. Anahtar isteğe eklendiğinde sunucu isteğin hangi uygulamadan geldiğini anlar. Geçerli anahtar, güvenli bir binaya giriş izni veren rozet gibi düşünülebilir; anahtar olmadan erişim sağlanmaz.

Kütüphane kartı benzetmesi konuyu somutlaştırır. Kütüphane size numaralı bir kart verir; kitap istemek için kartı gösterirsiniz. Bilgisayar numarayı kontrol eder ve yetkiniz varsa işlemi tamamlar. API anahtarı da servise gösterilen kart gibidir.

Anahtar almak için geliştirici genellikle sağlayıcının sitesine girer, hesap açar ve anahtar talep eder; anahtarı sağlayıcı üretir. Google Cloud Console örneğinde kullanıcı önce konsola girer ve servisleri yönetir. Anahtar tek bir alfanümerik dize olabilir; token ise daha uzun olabilir ve kullanıcıyı da tanımlayabilir.

Kimlik doğrulama yöntemleri

API anahtarı uygulamayı tanıtır; farklı ihtiyaçlar için başka yöntemler de vardır. OAuth, bir uygulamanın kullanıcı adına işlem yapması gerektiğinde izin akışı sağlar. JWT, imzalı ve süresi sınırlı bilgi taşır; sunucu imzayı doğrular.

Bir kuruluş bazı kullanıcılar için API anahtarı, bazıları için OAuth kullanabilir. Token'lar sınırlı kapsam ve süre ile üretilebilir; bu da yetkiyi daraltır. API anahtarı tek başına uygulamayı tanıtır, token ise daha fazla bilgi taşıyabilir.

Hangi yöntemin seçileceği veri duyarlılığına ve kullanıcı modeline bağlıdır. Kişisel veri içeren işlemlerde daha güçlü yöntemler tercih edilir. Salt okuma yapan iç servislerde anahtar yeterli olabilir.

Güvenlik ve iyi uygulamalar

API'ler yalnızca gerekli veriyi paylaşır ve iç sistem ayrıntılarını gizler. Bu ilke, saldırı yüzeyini daraltır. Anahtar gizli tutulmalı; istemci kodunda açık bırakılmamalıdır. İstekler güvenli bağlantı üzerinden gönderilmeli ve günlüklerde anahtar maskelenmelidir.

Kullanım sınırları ve izleme, kötüye kullanımın fark edilmesine yardımcı olur. Anahtar sızarsa iptal edilmeli ve yenisi üretilmelidir. Sürüm numaraları (v1, v2) değişiklikleri yönetir; eski sürümler belirli bir süre desteklenebilir.

Yanıtlar önbelleğe alınabilir; bu da tekrar istekleri azaltır. Tarayıcı önbelleği nasıl temizlenir konusu tarayıcı önbelleği nasıl temizlenir rehberinde anlatılır. Önbellek kullanırken güncel veri gereken uç noktalarda süre kısa tutulmalıdır.

API türleri ve tasarım notları

REST, SOAP ve GraphQL farklı tasarım stilleridir. REST tarzı API'ler HTTP yöntemleri ve kaynak odaklı adresler kullanır. SOAP daha katı mesaj yapıları kullanır. GraphQL istemcinin hangi alanları istediğini seçmesine izin verir.

Webhook'lar olay olduğunda veri gönderir; sürekli sorgulama yerine anlık bildirim sağlar. Sayfalama, büyük veri kümelerini parçalara böler. Hata mesajları açık ve tutarlı olmalıdır.

İyi bir API belgesi uç noktaları, parametreleri, örnek yanıtları ve hata kodlarını listeler. Geliştirici önce belgeyi okur, sonra test ortamında dener. Bu sıra hataları erken yakalar.

Sık yapılan hatalar

  • Anahtarı kaynak koduna gömmek.
  • Aşırı veri istemek veya gereksiz alanları çekmek.
  • Hata kodlarını yok saymak.
  • Sürüm ve kullanım sınırlarını okumamak.
  • Anahtarı günlük dosyalarına yazmak.

Bu hatalar erişim sorunlarına ve güvenlik açıklarına yol açar. Basit bir kontrol listesi bile riski azaltır.

API ve kullanıcı arayüzü farkı

API makine ile makine arasında çalışır; kullanıcı arayüzü insan ile makine arasında çalışır. API'de buton ve form yoktur; uç nokta ve parametre vardır. Kullanıcı arayüzü ise görsel öğelerle etkileşim kurar.

Bir uygulama her iki katmanı da kullanabilir. Arayüz kullanıcıdan veri alır; arka planda API bu veriyi işler. Bu ayrım, aynı API'nin web, mobil ve masaüstü uygulamalar tarafından kullanılmasını sağlar.

Sık sorulan diğer sorular

API ne işe yarar?

API, iki yazılımın veri ve işlev paylaşmasını sağlayan kurallar bütünüdür. Uygulamalar bu kurallar üzerinden kontrollü erişim elde eder.

API anahtarı neden gereklidir?

API anahtarı isteği yapan uygulamayı veya projeyi tanıtır. Geçerli anahtar erişim verir; geçersiz veya eksik anahtar isteğin reddedilmesine yol açar.

API ile web sitesi aynı şey midir?

Hayır. API makine ile makine arasında çalışır; web sitesi ise insanın kullandığı görsel arayüzdür. Aynı uygulama her iki katmanı da kullanabilir.

REST API ne demektir?

REST tarzı API, HTTP yöntemleri ve kaynak odaklı adresler kullanarak veri alışverişi yapar. GET, POST, PUT ve DELETE gibi yöntemler sık görülür.

İlgili sayfalar

  • Tarayıcı eklentisi nedir ve nasıl çalışır

    Tarayıcı eklentisi, web tarayıcısına yeni işlev ekleyen küçük bir yazılım modülüdür. Kurulumu genellikle resmi mağazalardan yapılır ve izinleri dikkatle incelenmelidir. Bu sayfa temel kavramları, çalışma biçimini ve güvenli kullanım adımlarını açıklar.

  • Bulut depolama nedir ve nasıl çalışır

    Bulut depolama, veriyi kullanıcının kendi cihazında değil, üçüncü taraf sağlayıcının yönettiği uzak sunucularda saklayan bir veri depolama modelidir. Kullanıcılar dosyalarına internet üzerinden erişir ve kapasite ihtiyaca göre artırılıp azaltılabilir. Bu sayede kurumlar kendi veri merkezlerini işletmek zorunda kalmaz.

  • Çok faktörlü kimlik doğrulama nedir ve nasıl çalışır

    Çok faktörlü kimlik doğrulama, parola gibi tek bir kanıt yerine iki veya daha fazla farklı kanıt türü isteyerek hesap erişimini güçlendirir. Yöntem; bilgi, sahiplik ve biyometri gibi farklı kategorileri birleştirir ve kimlik avı ile kimlik bilgisi hırsızlığı riskini azaltır. Uygulama ve yapılandırma kalitesi, yöntemin etkisini belirler.

  • SaaS ve on-premise arasındaki fark ve mimari analizi

    SaaS, yazılımların internet üzerinden tarayıcıyla çalıştırıldığı ve tüm altyapı yönetiminin sağlayıcı tarafından üstlenildiği bir abonelik modelidir. On-premise ise yazılımın şirketin kendi veri merkezindeki fiziksel sunuculara kurularak bakım, güvenlik ve donanım süreçlerinin dahili BT ekiplerince yürütüldüğü geleneksel dağıtım yöntemidir. İki model arasındaki temel ayrım; hız, bakım kolaylığı ve ölçeklenebilirlik ile tam veri egemenliği ve denetim arasındaki tercihe dayanır.

  • Malware Nedir: Kötü Amaçlı Yazılım Türleri ve Korunma

    Malware, bilgisayarlara, ağlara veya mobil cihazlara yetkisiz erişim sağlamak, veri çalmak ya da sistem işleyişini bozmak amacıyla tasarlanan kötü amaçlı yazılımların genel adıdır. Virüs, truva atı, casus yazılım ve fidye yazılımları gibi farklı türleri bulunan bu programlar; kimlik hırsızlığı, donanım kaynaklarının izinsiz kullanımı ve dosya şifreleme gibi zararlara yol açar. Korunma süreci düzenli sistem güncellemeleri, çok faktörlü kimlik doğrulama, uç nokta güvenliği ve bilinçli internet kullanımını gerektirir.

  • VPN Nasıl Çalışır? Ağ ve Tünelleme Mimarisi

    VPN, kullanıcının cihazı ile uzak bir sunucu arasında şifreli bir iletişim kanalı açarak çalışır. Cihazdan çıkan tüm internet trafiği bu tünelden geçirilir; böylece veriler şifrelenir ve kullanıcının gerçek IP adresi yerine VPN sunucusunun IP adresi görünür.

Bu sayfa nasıl hazırlandı

Yazmadan önce konu aşağıdaki kaynaklarda araştırıldı. Sayfa ardından otomatik kalite denetimlerinden geçti.

Bu sayfadaki bir hatayı bildir