API
API, iki yazılımın birbirine veri gönderip aldığı, kuralları önceden belli bir bağlantı kapısıdır. Siteniz kargo firmasına sipariş bilgisini API üzerinden gönderir, cevabı da aynı yoldan alır.
API nedir?
API, bir yazılımın başka bir yazılıma veri verdiği ya da ondan veri aldığı kapıdır. Açılımı Application Programming Interface, yani uygulama programlama arayüzüdür. Kapının kuralları bellidir: hangi bilgi, hangi biçimde, hangi adrese gönderilir, cevap nasıl döner.
Bir örnek verelim. Sitenizden sipariş geldi. Siteniz kargo firmasının API'sine alıcının adını ve adresini gönderir. Kargo firması bir takip numarasıyla cevap verir. Siteniz bu numarayı müşteriye e-postayla iletir. Arada kimse bir şey yazmaz, kopyalamaz. Aynı yol ödeme kuruluşu, banka ve muhasebe programı için de geçerlidir.
Neden önemli?
API, elle yapılan veri girişini bitirir. Aynı bilgiyi iki programa yazmak zaman alır ve hata üretir. Bir sistemi seçerken API sunup sunmadığına bakın. Sunmuyorsa ileride başka sistemlere bağlamak zorlaşır. Sistemlerinizi birbirine nasıl bağladığımızı entegrasyon sayfasında anlattık. Web projelerinde en sık kullanılan API türünü REST API maddesinde anlattık.
Sık sorulanlar
API ne işe yarar?
API, iki yazılımın elle veri girişi olmadan konuşmasını sağlar. Siteniz sipariş bilgisini kargoya, faturayı muhasebeye ve ödemeyi bankaya API üzerinden iletir. Aynı bilgi bir kez girilir, her yere kendiliğinden gider.
API ile entegrasyon arasındaki fark nedir?
API bir kapıdır, entegrasyon o kapıyı kullanarak iki sistemi bağlama işidir. Bir entegrasyonda çoğu zaman birden fazla API kullanılır. Hata durumları, yeniden deneme ve kayıt tutma da entegrasyonun parçasıdır.
Kullandığım programın API'si olup olmadığını nasıl anlarım?
Programın geliştirici belgelerine ya da destek ekibine sorun. API sunan firmalar genellikle bir belge sayfası ve deneme hesabı verir. API yoksa veri dosya aktarımıyla taşınabilir ama bu daha yavaş ve kırılgandır.
API kullanmak güvenli mi?
Doğru kurulursa evet. Her istek bir anahtar ya da token ile kimlik doğrular ve bağlantı şifreli gider. Anahtarlar kodun içine yazılmaz, sadece gereken yetki verilir.