API Nedir? İşletmeler İçin Anlaşılır Açıklama

Muhasebecinize “sitedeki siparişler programa otomatik düşsün” dediğinizde ya da yazılımcıdan “kargo firmasının API’si var mı?” sorusunu duyduğunuzda aklınıza ilk gelen soru büyük ihtimalle şudur: API nedir ve benim işimi neden ilgilendirir? Kısaca API (Application Programming Interface, uygulama programlama arayüzü), bir yazılımın başka bir yazılımdan veri istemesini ya da ona bir iş yaptırmasını sağlayan, kuralları önceden belirlenmiş bir iletişim kapısıdır. Bu yazıda konuyu teknik terimlere boğmadan, işletmenizdeki somut örneklerle anlatacağım.

API nedir? Bir restoran benzetmesiyle

Bir restoranda mutfağa doğrudan girip yemeğinizi kendiniz pişirmezsiniz. Garsona menüden seçtiğiniz yemeği söylersiniz, garson siparişi mutfağa iletir ve hazır tabağı size getirir. Mutfağın içinde ne olduğunu bilmeniz gerekmez; yalnızca menüdeki seçenekleri ve sipariş verme kuralını bilmeniz yeterlidir.

API tam olarak bu garsonun rolünü üstlenir. Menü, API’nin sunduğu işlemlerin listesidir; sipariş, sizin gönderdiğiniz istektir; tabak ise dönen cevaptır. Kargo firmasının sistemine “bu gönderinin durumu ne?” diye sorarsınız, sistem de size “dağıtımda” gibi bir yanıt döner. Kargo firmasının veritabanına, sunucusuna ya da iç yazılımına erişmeniz hiçbir zaman gerekmez.

İşletmenizde zaten kullandığınız API örnekleri

Farkında olmasanız da API’ler gün boyu sizin için çalışır. Birkaç tanıdık örnek:

Online ödeme: Sitenizde kartla ödeme alındığında site, ödeme kuruluşunun API’sine kart bilgisini güvenli biçimde iletir ve “onaylandı” ya da “reddedildi” cevabını alır. Konunun genel çerçevesini sanal POS entegrasyonu yazısında anlattım.
Harita: İletişim sayfanızdaki harita, bir harita servisinin API’si üzerinden çizilir.
Kargo takibi: Müşterinin sipariş sayfasında gördüğü kargo durumu, kargo firmasının API’sinden çekilir.
Canlı fiyatlar: Bir kuyumcu sitesindeki altın tablosu, fiyat kaynağından API ile alınır. Örneğin altın fiyatları eklentisi ve mobil uygulama projesinde web sitesi ve Flutter uygulaması aynı API’den beslenir.
Google ile giriş: “Google ile devam et” butonu da arka planda Google’ın kimlik API’lerini kullanır.

Bir API isteği nasıl işler?

Teknik detaya fazla girmeden bir isteğin yolculuğunu adım adım izleyelim. Diyelim ki e-ticaret siteniz bir siparişin kargo durumunu öğrenmek istiyor:

İstek hazırlanır: Siteniz, kargo firmasının belgelediği adrese bir istek gönderir. İsteğin içinde takip numarası ve size özel bir erişim anahtarı bulunur.
Kimlik kontrol edilir: Karşı taraf anahtarın geçerli olup olmadığına bakar. Anahtar yoksa ya da yanlışsa istek reddedilir.
İşlem yapılır: Sistem kendi veritabanından gönderinin durumunu bulur.
Cevap döner: Sonuç, genellikle JSON adı verilen, hem insanın hem makinenin okuyabildiği düzenli bir metin biçiminde gönderilir.
Siteniz cevabı kullanır: Gelen bilgi müşteri panelinde “Dağıtıma çıktı” şeklinde gösterilir.

Tüm bu süreç çoğu zaman bir saniyenin altında tamamlanır. Web dünyasında bu tür isteklerin büyük kısmı REST adı verilen yaklaşımla tasarlanır; ayrıntısını REST API nedir, nasıl tasarlanır yazısında bulabilirsiniz.

API türleri: Kime açık, ne amaçla?

API nedir sorusunu yanıtladıktan sonra sıradaki adım, hangi API’nin kime açık olduğunu anlamaktır. API’leri erişim düzeyine göre üç grupta düşünmek işinizi kolaylaştırır:

Tür	Kim kullanır?	Örnek
Açık (public) API	Kayıt olan herkes	Harita, döviz kuru veya hava durumu servisleri
İş ortağı (partner) API	Sözleşme yapılmış firmalar	Kargo, ödeme kuruluşu, pazaryeri entegrasyonları
İç (private) API	Yalnızca sizin sistemleriniz	Web siteniz ile mobil uygulamanızın ortak arka ucu

İç API’ler çoğu zaman gözden kaçar ama en çok fayda sağlayanlardan biridir. Web sitesi, mobil uygulama ve yönetim paneli aynı API’yi kullandığında bir fiyatı tek yerden değiştirirsiniz, değişiklik her yerde aynı anda görünür.

API’nin işletmeye sağladığı somut faydalar

API’yi teknik bir ayrıntı olarak değil, iş akışını hızlandıran bir araç olarak görmek gerekir. Doğru kurulmuş bir entegrasyonun getirdikleri şunlardır:

Elle veri girişinin azalması: Siparişleri muhasebe programına tek tek yazmak yerine otomatik aktarım yapılır, yazım hataları azalır.
Anlık bilgi: Stok, fiyat veya kargo durumu her zaman günceldir.
Yeni kanallara kolay açılma: Bugün web siteniz için yazılan bir API, yarın mobil uygulamanızı da besler.
Tedarikçi bağımsızlığı: İyi tasarlanmış bir yapıda kargo firmasını değiştirmek, tüm sistemi baştan yazmayı gerektirmez.

API kullanırken dikkat edilmesi gerekenler

API’ler büyük kolaylık sağlar ama birkaç konuyu baştan düşünmezseniz sorun çıkarabilir. İlki güvenliktir: erişim anahtarları bir şifre kadar değerlidir ve asla sitenin herkese açık kodunda tutulmamalıdır. İkincisi süreklilik: karşı taraftaki servis bir gün yavaşlayabilir ya da geçici olarak kapanabilir. Bu yüzden iyi bir entegrasyon, servis cevap vermediğinde son geçerli veriyi gösterecek ya da işlemi sıraya alacak şekilde yazılır.

Üçüncüsü değişen şartlardır. Üçüncü taraf servislerin kullanım limitleri, ücretleri ve sürümleri zaman içinde değişebilir. Bir entegrasyona başlamadan önce güncel şartları sağlayıcının kendi sitesinden kontrol etmenizi öneririm.

Bu işi nasıl birlikte yaparız?

İşletmenizde iki sistemi konuşturmak ya da kendi API’nizi kurmak istiyorsanız süreci genellikle şöyle yürütüyorum:

İhtiyacı dinleme: Hangi verinin nereden nereye, ne sıklıkla gitmesi gerektiğini ve bugün bu işi elle nasıl yaptığınızı konuşuruz.
Karşı tarafı inceleme ve teklif: Bağlanılacak servisin dokümantasyonunu inceler, mümkün olanı ve olmayanı netleştirir, kapsamı yazılı bir teklifle paylaşırım.
Geliştirme ve test: Entegrasyonu önce test ortamında kurar, hata durumlarını (servis kapalı, eksik veri, zaman aşımı) tek tek denerim.
Teslim ve destek: Canlıya alırken kayıt (log) tutulmasını sağlar, sonrasında oluşabilecek sürüm değişikliklerinde destek veririm.

Aklınızdaki entegrasyonu kısaca anlatmak isterseniz iletişim sayfasından bana ulaşabilirsiniz.

Sık sorulan sorular

API kullanmak için yazılım bilmem gerekir mi?

Hayır. İşletme sahibi olarak hangi verinin nereye gitmesi gerektiğini bilmeniz yeterlidir. Teknik kurulumu bir geliştirici yapar; siz sonucu panelde ya da raporlarda görürsünüz.

Her yazılımın API’si var mıdır?

Hayır. Bazı eski veya kapalı programlar dışarıya API sunmaz. Bu durumda dosya aktarımı gibi alternatif yollar değerlendirilir ya da sağlayıcıyla görüşülür.

API ile web servis aynı şey mi?

Günlük kullanımda çoğu zaman aynı anlamda kullanılır. Web servis, internet üzerinden erişilen API’ler için kullanılan bir terimdir; her web servis bir API’dir ama her API web üzerinden çalışmak zorunda değildir.

API kullanımı ücretli midir?

Servise göre değişir. Bazı API’ler ücretsizdir, bazıları belirli bir kullanım miktarından sonra ücretlendirilir. Güncel şartları her zaman sağlayıcının sitesinden kontrol etmek gerekir.

Sonuç

API nedir sorusunun işletme için cevabı basit: sistemlerinizin birbiriyle elle müdahale gerekmeden konuşmasını sağlayan kurallı bir kapıdır. Ödemeden kargoya, muhasebeden mobil uygulamaya kadar pek çok işi hızlandırır. Kendi işletmenizde nereden başlayacağınızı birlikte değerlendirmek isterseniz bana yazabilirsiniz.