Ana içeriğe geç

Entegrasyonlar dosyasıÖzel Yazılım ve Paneller

API entegrasyonu nedir? İşletme için sade anlatım

Kısaca

API, bir yazılımın başka bir yazılımdan belirli bir iş istemesinin kuralıdır: ödeme almak, SMS göndermek, takvim eşitlemek. Entegrasyon bu bağlantının kurulması. Bilmeniz gereken üç risk: istek başına ücret, anahtarın sızması ve karşı tarafın API'yi değiştirmesi ya da kapatması; Google bir API'yi 3 Kasım 2025'te kapattı ve yerine bir şey sunmadı.

Eskimiş yeşilimsi bir yüzeyde, aralarında küçük bir boşluk bırakarak birbirine bağlanmak üzere duran iki pirinç konnektör ucu; yeşil örgülü bir kablo ve kehribar renkli küçük bir cam parça
Yazan
Ahmet Tuğralp Dindi
Yayın
Okuma
3 dk
Kaynak
5
Bölüm
5
Dosya
Entegrasyonlar

API ne demek, restorandan bir benzetmeyle

API, restoranda garson gibi çalışır. Mutfağa (karşı yazılım) giremezsiniz; garsona (API) siparişi söylersiniz, o iletir ve yemeği getirir. Garsonun anladığı bir menü vardır: ne isteyebileceğinizi o belirler.

MDN bunu daha teknik anlatıyor: API, bir yazılımın içindeki özellikler ve kurallar kümesidir ve bu yazılımla insan arayüzü yerine yazılım yoluyla etkileşmeyi sağlar. Uygulamayı sunan taraf ile üçüncü taraf yazılım arasında basit bir sözleşme gibidir1.

Entegrasyon ise bu sözleşmeyi kullanarak iki sistemi birbirine bağlamak. Örnekler: sitenizdeki sipariş sanal POS'a ödeme isteği gönderiyor, rezervasyon panelinizden müşteriye SMS çıkıyor, kargo firmasından takip numarası geliyor.

API ile webhook farkı nedir?

API'de siz sorarsınız: "bu siparişin ödemesi geldi mi?" Webhook'ta karşı taraf size haber verir. Stripe'ın dokümanına göre bir webhook adresi kaydedince, olaylar olduğunda Stripe gerçek zamanlı veriyi o adrese gönderiyor; örneğin müşterinin bankası bir ödemeyi onayladığında2. Panelinizde "ödeme geldi" durumunun hemen görünmesi çoğu zaman böyle çalışır.

Entegrasyonun üç riski

İstek başına ücret

Bazı API'ler her istekte para alıyor. OWASP, API'ler üzerinden sunulan e-posta, SMS ya da telefon aramaları gibi kaynakların istek başına ödenen servisler olduğunu ve saldırının işletme maliyetini artırabileceğini yazıyor3. Yani formunuz kötü niyetli biri tarafından otomatik doldurulursa SMS faturanız şişebilir. Bu yüzden yazılımcıya sorun: istek sınırı var mı, form spam korumalı mı?

Kullanım sınırı API'lerin kendi önlemi de: GitHub, belirli sürede yapılabilecek istek sayısını kötüye kullanımı ve hizmet engelleme saldırılarını önlemek için sınırladığını yazıyor ve kimliksiz isteklerde saatte 60 isteği sınır olarak veriyor5. Her servisin sınırı farklı; kullandığınız servisin sınırını ve aşılırsa ne olacağını öğrenin.

Anahtar ve yetki sızıntısı

API'yi kullanmak için genelde bir anahtar (API key) verilir; bu, şifre gibi korunmalı. OWASP'ın listesinde ilk sıradaki sorun, kimliği sayıyla belirtilen bir veriye erişirken yetkinin kontrol edilmemesi: örneğin bir müşteri adresteki numarayı değiştirip başkasının siparişini görebilir3. Ayrıca kimlik doğrulama mekanizmalarının yanlış kurulması saldırganların başkasının kimliğine bürünmesine yol açabiliyor3.

İşletme olarak bilmeniz gereken: anahtar kimin elinde, hangi kayıtlarda duruyor, ayrılan bir geliştirici sonrası değiştirildi mi?

Karşı taraf API'yi değiştirir ya da kapatır

Bu üçünün en az konuşulanı. Google My Business Soru-Cevap API'si 3 Kasım 2025'te kapatıldı; Google 15 Eylül 2025'te desteği bitirdi ve yerine hiçbir şey sunmadı4. O API'ye bağlı her entegrasyon bir gün çalışmayı bıraktı. Karşı tarafın kararına bağlı bir bağımlılığı sıfıra indiremezsiniz, ama yönetebilirsiniz: bağlandığınız servislerin listesini tutun, bakım sözleşmesinde "karşı API değişirse onarım kapsamda mı" sorusunu yazılı cevaplayın.

Entegrasyon bedeli neden tek rakam değil?

Çünkü maliyeti dört şey belirliyor: karşı sistemin dokümanının kalitesi, kaç veri akışı olduğu (sipariş içeri mi, stok dışarı mı, ikisi birden mi), hata olduğunda ne olacağı (yeniden deneme, bildirim) ve karşı tarafın istek başına ücret alıp almadığı. Teklif istediğinizde bunları sorun; "entegrasyon dahil" yazan ama hangi akışların dahil olduğunu söylemeyen teklif eksiktir.

Yazılımcıya sorulacak beş soru

  • Hangi servislerin API'sini kullanıyoruz ve dokümanları güncel mi?
  • Anahtarlar nerede tutuluyor, ben erişebiliyor muyum?
  • Bir istek başarısız olursa ne oluyor, kim haberdar oluyor?
  • Karşı taraf API'yi kapatırsa onarım bakım kapsamında mı?
  • Kullanım sınırına yaklaştığımızda nasıl öğreneceğiz?

Entegrasyonlar sipariş, rezervasyon ve panel gibi sistemlerin kalbinde. Kapsamı özel panel ve yazılım sayfamızda anlattık; randevu tarafında hangi soruların sorulması gerektiğini ise randevu sistemi için 10 soruda topladık.

Kaynaklar, metindeki numaralarla

  1. MDN Web Docs: API (sözlük)developer.mozilla.org, erişim
  2. Stripe Dokümantasyonu: Webhooksdocs.stripe.com, erişim
  3. OWASP: API Security Top 10, 2023api-security.owasp.org, erişim
  4. GitHub Docs: REST API için hız sınırlarıdocs.github.com, erişim

Sıradaki ve ilgili

Sık sorulan sorular

Sorunuz burada yoksa bize yazın.

Bu konuda yardıma mı ihtiyacınız var?

Durumunuzu anlatın, kapsamı ve süreyi yazılı olarak çıkaralım.