API Nedir?

Birçok ekip API’yi uç sanır. Adres yazılır, anahtar verilir, cevap gelir, kayıt “sonra bağlanır” denir. Dört adım vardır; dört gerçek vardır. “API nedir?” sorusunun cevabı bu tabloda yoktur. Çalışan sözleşme, çağrıyı çoğaltmaz; kimliği tek tutar. Kavram, uygulama programlama arayüzü tanımından ayrı durmaz; burada protokol değil, işin nasıl konuşulduğu anlatılır.

İkinci kırılma, protokolü sözleşme sanmaktır. Protokol taşıyıcıdır. API, o taşıyıcının üstünde kimliğin kilitlenmesidir. Üçüncü kırılma, cevabı kapanış sanmaktır. “200 döndü” iş kapanmış demek değildir. Kapanış, isteğin, kimliğin ve cevabın aynı kaydı konuşmasıdır.

Shopsoft bu sayfada ticari paketi dayatmaz. Anlatılan şey, isteğin nasıl kimliklendiği, cevabın nerede durduğu ve hatanın nasıl taslakta kaldığıdır. Özel yazılım geliştirme kaydı kurabilir. Kuruluş, kavramı çalmaz; ev sahibi olur.

Yaklaşım üç katmandadır. Birincisi istek: kim neyi sorar. İkincisi kimlik: hangi kayıt taşınır. Üçüncüsü cevap: karşı taraf neyi kabul eder. Bu sayfa ticari katmanı çalmaz; halkaları anlatır. Ticari derinlik API geliştirme sayfasındadır.

Tipik bir sabah: operasyon 18 siparişi karşı sisteme sorar. Üç olayda eşik aşılır; taslakta kalır. İki olayda karşı taraf reddeder; çift kayıt doğmaz. Yetki, o kullanıcının kesitinden gelir; “eski kodu hatırlıyorum” cümlesi kayda girmez.

Öğleden sonra ikinci kanal aynı kaydı okur. Kimlik düşer, stok satıra bağlanır. Akşam kapanış, onaylanan cevaplardan doğar. Durum görünür: taslak, kilitli, kapandı. Telefon zinciri “geçti mi?” diye dönmez.

API ada olarak yaşamaz. ERP’de sipariş, vitrinde stok, mailde belge duruyorsa her biri ayrı gerçek üretir. Kavram mevcut sistemi atmayı hedeflemez. İş kaydı aynı olaya bağlanır.

Entegrasyon “uç var mı?” sorusu değildir. İstek düştüğünde karşı sistemin aynı kimliği kabul etmesi, hata olursa taslakta kalması, tekrar denemede çift kayıt doğurmaması kararlarıdır. Bu kararlar omurgada kilitlenir. Webhook, dosya veya kuyruk ihtiyaca göre seçilir; her projede aynı yığın vaat edilmez.

Teknik yaklaşım, belirli bir protokol veya bulut ürününü her projede zorunlu kılmaz. Cloud, hibrit veya mevcut sunucu kararı şirketin güvenlik ve operasyon tercihine bağlıdır. Shopsoft bunu keşifte konuşur; pazarlama cümlesi olarak kilitlemez.

Olmazsa olmaz olan kayıttır. İstek satırı kimliklidir. Sözleşme sürümlenir. Cevap olayı işe bağlanır. Yetki, ekran gizleme değil veri süzme olarak uygulanır. Log, “kim neyi değiştirdi” sorusunu cevaplar. Bu disiplin olmadan şık uç ikinci bir Excel olur.

API’de güvenlik önce yetkidir. Birim komşu kanalın siparişini görmez. Operasyon tüm sözleşmeyi açamaz. Finans, kilit düşmeden kapanışı zorlamaz. Rol, unvan etiketi değil veri sınırıdır. Bu sayfa pentest vaadi yazmaz.

Yönetişim, değişikliğin kimin onayında olduğunu söyler. Sözleşme güncellemesi, yeni kanal açılışı, yetki artışı rastgele yapılmaz. İz bırakır. KVKK kapsamındaki iş ve kişi verisi, resmi belge numarası uydurmadan; erişim ve saklama disiplinine bağlanır.

Sık görülen birinci hata, API’yi uç sanmaktır. Adres ve pano durur; kural Excel’de kalır. Kullanıcı çağrı atar, merkez yeniden yazar. İkinci hata, her ihtiyacı aynı sayfada çözmektir. Ticari omurga, REST yüzeyi, webhook ve senkron ayrı niyetlerdir; bu sayfa onları birincil hedef almaz.

Üçüncü hata, mevcut sistemi atıp her şeyi yeni kapıda yeniden icat etmektir. Kayıt ve belge çoğu şirkette vardır. Kavram onları yok saymaz, iş diline bağlar. Dördüncü hata, yetkiyi menü gizleme sanmaktır. Gizli menü, uç veya raporla aşılır. Yetki veridedir.

Bu sayfa API’nin ne olduğunu anlatır. API geliştirme ticari niyettir. REST yüzeyi, webhook, senkron ve proje planı ayrı arama niyetleridir. Burada bağları görünür; birincil hedef olarak derinleşmez. Kullanıcı hangi darboğazda duruyorsa ilgili sayfaya geçer.

Sözleşme yoksa alt sayfa da şişmez. Uç, kuyruk veya kanal, iş kimliği tek değilse ikinci gerçek üretir. Bu yüzden açıklama çoğu kez istek ve kimlikten başlar. İlk dilim istek, kimlik ve cevap üçlüsünü kapatır. Geri kalan yüzeyler bu üçlüye bağlanır.

Shopsoft, SS Danışmanlık çatısında 2004’ten bu yana yazılım üretir. Türkiye ve yurtdışında 700+ ajansa altyapı ve yazılım desteği verilmiştir. Merkez İstanbul Ataşehir’dedir. Uluslararası işlerde yerel dilde iletişim kurabilen bölgesel ağ devreye girer.

Resmi uyumluluk kapsamı, belge onaylanmadan kesin yazılmaz. Performans yüzdesi, müşteri sayısı uydurması ve rakip karşılaştırması yoktur. Müşteri logoları güven unsuru olarak kullanılabilir; gizli mimari ve vaka detayı yayınlanmaz.