API (Application Programming Interface)

API, iki yazılımın birbiriyle konuşmasını sağlayan standartlaştırılmış bir arabirimdir. Bir programın hangi verileri isteyebileceğini ve yanıtı hangi biçimde alacağını tam olarak tanımlar — müşteri (yazılımınız) ile mutfak (platformumuz) arasında gidip gelen bir garson gibi.

API nedir?

API, «Application Programming Interface» (Uygulama Programlama Arabirimi) ifadesinin kısaltmasıdır. API, iki yazılım sisteminin bilgi alışverişi için kullandığı üzerinde anlaşılmış bir dildir. Üzerinde işlem yaptığınız bir program değil, bir sözleşmedir: «Bana A gönderirsen, sana B döndürürüm.»

Bir restoranı hayal edin. Müşteri olarak mutfağı görmezsiniz. Garsonla konuşursunuz. Garson menüyü (= API dokümantasyonu) bilir, siparişinizi sabit bir biçimde («domates soslu makarna») alır ve sonucu getirir. Mutfak değişebilir — yeni şefler, yeni ekipman — ve garson aynı menüyü koruduğu sürece deneyiminiz aynı kalır. Bir API, yazılımınızın ne istediği ile alt servisin bunu nasıl sunduğunu tam olarak bu şekilde birbirinden ayırır.

API'ler neden önemlidir

API'ler modern yazılımın görünmez omurgasıdır. Muhasebe aracınız Stripe ile konuştuğunda, çevrimiçi mağazanız gerçek zamanlı stok kontrol ettiğinde, web sitenize Google Haritalar gömüldüğünde — perde arkasında bir API çalışır. API'ler olmasa her şirket her özelliği kendisi inşa etmek zorunda kalırdı. API'lerle uzmanlaşmış servisler tıpkı yapı taşları gibi bir araya getirilir.

SendSeven bağlamında API

SendSeven, yazılımınızın WhatsApp, SMS, e-posta, Telegram, Instagram, Messenger ve canlı sohbet üzerinden mesaj göndermesine, kişileri yönetmesine ve konuşmaları okumasına olanak tanıyan bir API sunar. Üç somut örnek:

  • Çevrimiçi mağaza: Her siparişten sonra mağazanız otomatik olarak bir WhatsApp onayı gönderir — elle yazmadan.
  • CRM: Bir potansiyel müşteri «sıcak» statüsüne geçtiği anda CRM, müşterinin tercih ettiği kanal üzerinden kişiselleştirilmiş bir mesaj tetikler.
  • Helpdesk: Gelen WhatsApp mesajları, ters yönde webhook üzerinden helpdesk sisteminize ticket olarak düşer.

API türleri

Tüm API'ler aynı şekilde çalışmaz. En yaygın varyantlar:

  • REST API: Web API'leri için günümüzün standardı. HTTP'yi bir tarayıcı gibi kullanır, kullanımı kolaydır, her programlama setinde desteklenir. SendSeven REST kullanır.
  • GraphQL: İstemcinin hangi alanları geri istediğini tam olarak belirttiği bir varyant. Karmaşık veri modelleri için daha verimlidir.
  • WebSocket: Sunucunun olayları kendisinin ittiği (örneğin «yeni mesaj alındı») gerçek zamanlı bağlantılar için.
  • MCP Server: Özellikle Claude veya GPT gibi yapay zekâ ajanları için tasarlanmış daha yeni bir arabirim türü.

Kimlik doğrulama: kim ne yapabilir?

API'ler herkese açık değildir. Her çağrı kendini tanıtmak zorundadır. SendSeven, parola gibi çalışan gizli ve kişisel bir belirteç olan API Key kullanır. Anahtara sahip olan kişi sizin adınıza hareket edebilir. Bu nedenle API anahtarı asla frontend'de, asla genel bir GitHub deposunda, asla bir e-postada bulunmamalıdır.

İşler ters gittiğinde ne olur?

Her API bir durum koduyla yanıt verir. 200 OK her şey yolunda anlamına gelir. 401 kimlik doğrulamanın başarısız olduğu anlamına gelir. 429 çok fazla istek anlamına gelir — bkz. rate limiting. 500 sunucu tarafı hata anlamına gelir. İyi bir entegrasyon durum kodunu kontrol eder ve mantıklı tepki verir — örneğin, kısa bir aradan sonra yeniden dener.

API vs Konektör vs SDK

Bu üç terim sıkça birbirine karıştırılır:

  • API: Ham arabirim — HTTP çağrıları, JSON yanıtlar. Programlama bilgisi gerektirir.
  • SDK: Geliştiriciler için API'yi basitleştiren önceden hazırlanmış kütüphane (Python, JavaScript, PHP…).
  • Konektör (Bağlayıcı): Belirli bir üçüncü taraf sisteme yönelik hazır entegrasyon (örneğin Shopify konektörü). Çoğu zaman kod yazmadan kullanılabilir.

KOBİ olarak API'ye ihtiyacım var mı?

Kısa cevap: yalnızca standart olarak mümkün olmayan bir şeyi otomatikleştirmek istiyorsanız. SendSeven, teknik derinliğinize göre üç yol sunar:

  1. Platform: Kod yerine tıklama — müşteri hizmetleri ve pazarlama için varsayılan yol.
  2. Konektörler: Shopify, HubSpot, Zapier vb. için hazır entegrasyonlar — genellikle kodsuz.
  3. API: Özel iş akışları, kendi yazılımınız veya toplu işlemler için.