SDK (Software Development Kit)

SDK (Software Development Kit), bir API'yi tek bir programlama dili için fonksiyonlara dönüştüren, kod kütüphaneleri, araçlar ve dokümantasyondan oluşan hazır bir pakettir. Geliştiriciler ham HTTP istekleri yazmak yerine hazır fonksiyonları çağırır.

SDK Nedir?

SDK (Software Development Kit), tek bir programlama dili için kod kütüphaneleri, araçlar ve dokümantasyondan oluşan hazır bir pakettir. Geliştiricilerin bir API ile çalışmak için doğrudan çağırabileceği fonksiyonlar sunar. HTTP isteklerini elle oluşturmak, JSON yanıtlarını okumak ve hataları kendiniz yakalamak yerine client.messages.send() gibi tek bir satır yeterlidir. Gerisini SDK halleder.

İki türü vardır. Hafif bir SDK, API uç noktalarını bire bir yansıtır ve çoğunlukla tür tanımları ekler. Kapsamlı bir SDK ise otomatik yeniden denemeler, sayfalama veya webhook imzalarının doğrulanması gibi ek kolaylıklar sunar. Her SDK tek bir dile bağlıdır: Python, JavaScript ve PHP geliştiricilerine hizmet vermek isteyen bir sağlayıcı, üç ayrı paket geliştirip güncel tutmak zorundadır.

SDK mı, doğrudan REST API mi?

SDK her zaman bir API üzerinde çalışan bir katmandır. Bu API genellikle bir REST API olur. İki yol da aynı sonuca götürür. Fark, harcanan emekte yatar:

• SDK ile: daha hızlı başlangıç, tür güvenli fonksiyonlar ve kodda daha az hata. Buna karşılık, sağlayıcının paketi kendi diliniz ve sürümünüz için güncel tutmasına bağımlı olursunuz.
• Doğrudan REST ile: HTTP isteği gönderebilen her dilde, ek paket olmadan çalışır. Neyin iletildiğini tam olarak görürsünüz, ancak kimlik doğrulama, hata yönetimi ve yeniden denemeleri kendiniz yazarsınız.

Çoğu mesajlaşma entegrasyonu için birkaç doğrudan REST çağrısı yeterlidir: kimlik doğrulama, mesaj gönderme, durum güncellemelerini alma. Bu yüzden birçok ekip SDK kullanmaz ya da kendi istemcisini API tanımından oluşturur.

OpenAPI spesifikasyonundan kendi istemciniz

Birçok API bir OpenAPI spesifikasyonu yayınlar: her uç noktayı, her parametreyi ve her yanıtı tanımlayan, makinenin okuyabildiği bir dosya. Bu dosyayla, resmi bir paket beklemeden bir SDK'nın sunduklarının büyük bölümünü elde edersiniz:

• İstemci kodu oluşturma: OpenAPI Generator gibi araçlar, spesifikasyondan diliniz için tür güvenli bir istemci üretir.
• API araçlarında test etme: Postman, Insomnia veya Bruno spesifikasyonu içe aktarır. Böylece kod yazmadan önce her uç noktayı deneyebilirsiniz.
• Yapay zeka kodlama araçlarını kullanma: Claude Code, Cursor veya GitHub Copilot gibi asistanlar spesifikasyonu ve dokümantasyonu okuyup teknoloji yığınınız için entegrasyon kodunu yazar.

SendSeven'da SDK'lar

SendSeven, REST API'si için dile özel SDK'lar sunmaz. Tek SDK, Push SDK'dır: kendi web sitenize tarayıcı push bildirimleri ekleyen küçük bir kod parçası. Diğer her şey için doğrudan REST API'ye bağlanırsınız ve şu yardımcılardan yararlanırsınız:

• OpenAPI spesifikasyonu: istemci kodu oluşturun veya Insomnia ya da Bruno'ya içe aktarın.
• Postman koleksiyonu: uç noktaları denemek için hazır istekler.
• Yapay zeka kodlama araçları için dokümantasyon: docs.sendseven.com üzerindeki her sayfa Markdown olarak da mevcuttur. Ayrıca Claude Code, Cursor ve GitHub Copilot için hazır bir istem (prompt) bulunur.
• MCP sunucusu: Claude gibi yapay zeka ajanları doğrudan SendSeven ile çalışır.
• Kodsuz: Zapier, Make ve n8n, SendSeven'i programlama olmadan diğer araçlara bağlar.

Kimlik doğrulama, Bearer token olarak gönderilen bir API anahtarı ile yapılır. Adım adım talimatları API kimlik doğrulama rehberinde, tüm uç noktaları ise geliştirici dokümantasyonunda bulabilirsiniz.