Bir yazılım firmasıyla görüştüğünüzde ya da bir entegrasyon teklifi aldığınızda "API" kelimesini mutlaka duyarsınız. "Sizin ERP'nin API'si var mı?", "Kargo firmasına API ile bağlanırız" gibi cümleler, teknik olmayan biri için kafa karıştırıcı olabilir. Oysa API'nin mantığı oldukça basittir ve bir kez anladığınızda yazılım kararlarınızı çok daha rahat verirsiniz. Bu yazıda API'yi hiçbir teknik bilgi gerektirmeden anlatıyoruz.
API nedir?
API, İngilizce "Application Programming Interface" ifadesinin kısaltmasıdır. Türkçeye "uygulama programlama arayüzü" olarak çevrilir ama bu çeviri pek bir şey anlatmaz. En sade haliyle API, iki yazılımın birbiriyle konuşmasını sağlayan kurallar bütünüdür.
Bunu bir restoran örneğiyle düşünebilirsiniz. Siz masada oturuyorsunuz, mutfak ise arka tarafta. Mutfağa kendiniz girip yemek yapmazsınız. Garsona ne istediğinizi söylersiniz, garson siparişi mutfağa iletir ve hazır olan yemeği size getirir. Burada garson, API'dir. Siz ve mutfak birbirinizin nasıl çalıştığını bilmek zorunda değilsiniz. Tek yapmanız gereken, garsonun anladığı şekilde sipariş vermektir.
Yazılımlarda da durum aynıdır. B2B portalınız ERP sisteminizden stok bilgisini öğrenmek istediğinde ERP'nin içine girip veritabanını karıştırmaz. ERP'nin API'sine "şu ürünün stoğu kaç?" diye sorar, API de cevabı geri getirir.
Günlük hayatta API'yi zaten kullanıyorsunuz
Farkında olmasanız da API'lerle her gün karşılaşıyorsunuz:
- Bir alışveriş sitesinde kartla ödeme yaptığınızda site, bankanın sistemine API üzerinden bağlanır.
- Kargo takip numaranızı girdiğinizde bilgi kargo firmasının sisteminden API ile gelir.
- Bir uygulamaya "Google ile giriş yap" diyerek girdiğinizde iki sistem API ile konuşur.
- Telefonunuzdaki hava durumu uygulaması verileri bir meteoroloji servisinin API'sinden alır.
Bu örneklerin ortak noktası, iki farklı sistemin kullanıcıya hissettirmeden bilgi alışverişi yapmasıdır. Banka, alışveriş sitesine müşterilerinin tüm hesap bilgilerini açmaz; sadece "bu ödeme onaylandı mı?" sorusuna cevap verir. API'nin güzel yanlarından biri de budur: Karşı tarafa yalnızca izin verdiğiniz bilgiyi, izin verdiğiniz şekilde ulaştırır. Bu nedenle iyi tasarlanmış bir API, veri güvenliğinin de önemli bir parçasıdır.
B2B işinizde API ne işe yarar?
Bir üretici, distribütör ya da toptancı için API, farklı yazılımların ayrı adalar gibi çalışmasını engeller. Bilginin elle bir yerden diğerine taşınmasına gerek kalmaz.
| Bağlantı | API sayesinde ne olur? |
|---|---|
| ERP ile B2B portalı | Stok, fiyat ve siparişler iki tarafta da aynı anda güncellenir |
| B2B portalı ile kargo firması | Gönderi otomatik oluşur, takip kodu müşteriye iletilir |
| B2B portalı ile pazaryerleri | Trendyol, Hepsiburada gibi kanallardaki stoklar tek kaynaktan beslenir |
| Portal ile e-Fatura sistemi | Sipariş tamamlandığında fatura elle kesilmeden oluşur |
| Portal ile banka | Sanal POS üzerinden alınan ödemeler cari hesaba işlenir |
API olmadan bu işlerin her biri için bir çalışanın verileri bir ekrandan okuyup diğerine yazması gerekir. Bu hem zaman alır hem de hata riskini artırır.
Somut bir örnekle düşünelim. Bir bayiniz akşam saatlerinde B2B portalından sipariş verdi. API ile çalışan bir düzende sipariş anında ERP'ye düşer, stok düşülür, ertesi sabah depo ekibi hazırlığa başlar, kargo gönderisi oluşturulur ve takip kodu bayiye SMS ya da WhatsApp ile iletilir. Aynı sürecin API olmadan işlediğini düşünün: Sabah biri siparişi görür, ERP'ye elle girer, kargo firmasının sitesine ayrıca kayıt açar ve takip kodunu bayiye telefonla bildirir. Her adımda bir yazım hatası ya da gecikme ihtimali vardır.
Sık duyacağınız birkaç terim
Yazılım görüşmelerinde API ile birlikte birkaç kelime daha geçer. Hepsini bilmeniz gerekmez ama kabaca ne anlama geldiklerini bilmek işinizi kolaylaştırır.
- REST ve SOAP: API'lerin konuşurken kullandığı iki yaygın yöntemdir; restorandaki örnekle düşünürsek siparişin hangi formatta yazıldığını belirler.
- XML: Verilerin düzenli bir şekilde paketlenip gönderildiği bir dosya biçimidir; ürün listelerinin paylaşılmasında sık kullanılır.
- Webhook: Bir olay gerçekleştiğinde karşı sisteme kendiliğinden haber veren bir yöntemdir; "sipariş geldi" bilgisinin beklemeden iletilmesi gibi.
- Entegrasyon: İki sistemin API ya da benzeri yollarla birbirine bağlanması işinin genel adıdır.
Yazılım seçerken sorulacak sorular
- Sistemin açık ve belgelenmiş bir API'si var mı?
- Kullandığım ERP ile hazır bir bağlantı bulunuyor mu?
- Hazır bağlantı yoksa XML veya REST/SOAP üzerinden bağlanabilir miyiz?
- Veri akışı tek yönlü mü, çift yönlü mü?
- Bağlantıda sorun çıktığında kim destek veriyor?
Multistok bu sorulara net cevaplar verir. REST API, XML ve webhook desteği sunar; Logo, Mikro, Netsis, Nebim, SAP ve Dynamics gibi yaygın ERP sistemleri için hazır bağlantıları vardır. XML veya REST/SOAP destekleyen her sisteme bağlanabilir, gerekirse özel bir köprü de yazılır. API erişiminin hangi paketlerde yer aldığını paketler sayfamızda görebilirsiniz. Bulut tabanlı yazılımların nasıl çalıştığını merak ediyorsanız SaaS nedir yazımız da işinize yarayabilir.
Sonuç
API, yazılımlarınızın birbiriyle konuştuğu ortak dildir. Teknik detaylarını bilmeniz gerekmez; bilmeniz gereken, kullandığınız sistemlerin bu dili konuşup konuşmadığı ve bilginin sizin müdahaleniz olmadan doğru yere ulaşıp ulaşmadığıdır. Kendi ERP'nizin Multistok ile nasıl bağlanacağını görmek isterseniz demo talep edebilirsiniz.
