API (uygulama programlama arayüzü)

API (Application Programming Interface, uygulama programlama arayüzü), iki yazılımın birbiriyle konuşması için tanımlanmış kurallar bütünüdür. Bir yazılım belirli bir adrese istek gönderir; karşı taraf isteği yetkili bulursa belirli bir biçimde cevap verir.

Basit bir benzetme

API bir restoranın menüsüne benzer: Mutfağın nasıl çalıştığını bilmeniz gerekmez; menüdeki bir şeyi doğru biçimde istersiniz ve tabağınız gelir. Menüde olmayan bir şeyi isteyemezsiniz.

Bir API isteğinin parçaları

• Uç (endpoint): İsteğin gönderildiği adres, ör. /v1/santral/calls.
• Yöntem: Ne yapılacağı; GET okur, POST yeni bir şey oluşturur.
• Kimlik: İsteği kimin gönderdiğini kanıtlayan API anahtarı ya da jeton.
• Gövde ve cevap: Gönderilen ve dönen veri, çoğunlukla JSON biçiminde.

Olay olduğunda karşı tarafın size kendiliğinden haber vermesi ise webhook ile olur; API'de istek hep sizden çıkar.

KuleConnect'te

• KuleConnect API'si: Kendi yazılımınız santralde arama başlatabilir ve çağrıları sorgulayabilir, WhatsApp ya da Telegram ile doğrulama kodu gönderebilir, randevu aktarabilir. Anahtar Yönet → API Anahtarları sayfasında üretilir; her istek anahtar ve imza başlıklarıyla gönderilir.
• Uçların dakikalık sınırı vardır; sınır aşılırsa istek 429 koduyla reddedilir.
• Başka servislerin API'leri: NetGSM, WhatsApp Cloud API, mağaza platformları ve yapay zekâ servisleri gibi bağlantılar Ayarlar → Entegrasyonlar ekranından kurulur.

İlgili rehber

Anahtar alma, imza hesaplama ve hata kodları için KuleConnect API'sine genel bakış ve kimlik doğrulama yazısına bakın. Mimari için REST API maddesini okuyun.