API entegrasyon projesi; kaynak ve hedef sistemler, taşınacak veri, işlem kuralları ve başarısızlık senaryolarıyla tanımlanmalıdır. Bağlantının bir kez çalışması, tekrar eden işlemlerin ve hataların güvenle yönetildiğini tek başına göstermez.
Kaynak ve hedef akış nasıl tarif edilir?
Hangi sistemin hangi veri için asıl kaynak olduğunu belirleyin. Müşteri, stok veya sipariş bilgisini birden çok tarafta değiştirmek çakışma doğurabilir. Veri alanlarının karşılığı ve güncelleme yönü baştan yazılmalıdır.
Örnek senaryo: mağazada oluşan sipariş muhasebe sistemine aktarılıyor. Sipariş değiştiğinde neyin güncelleneceği, iptalin nasıl bildirileceği ve aktarım başarısızsa kimin haberdar olacağı da kapsamın parçasıdır.
Bağlantı öncesi hangi erişimler gerekir?
- Güncel API belgesi ve sağlayıcı sorumlusu.
- Gerekli yetkiye sahip erişim yöntemi.
- Mümkünse üretimden ayrılmış test ortamı.
- Örnek veri ve alan eşleştirme listesi.
- İstek kotası ve servis bağımlılıklarına ilişkin bilgi.
Erişim anahtarlarını makale yorumuna veya herkese açık dokümana yazmayın. Gereken erişim güvenli kanaldan ve görevle sınırlı paylaşılmalıdır.
Hata ve tekrar deneme nasıl test edilir?
Dış sistem cevap vermediğinde, beklenmeyen veri geldiğinde veya aynı işlem yeniden gönderildiğinde ne yapılacağı belirlenir. İşlem kaydı, mükerrer veri kontrolü ve sorumluya bildirim kabul senaryolarına eklenir.
OWASP API güvenliği çalışması, kimlik, nesne erişimi, kaynak kullanımı ve dış API tüketimi gibi risklerin önemini açıklar. Üretim ortamında uygulanacak kontroller gerçek tasarıma göre seçilir.
Teknik başvuru: OWASP — API güvenliği riskleri.
İşin teslimi nasıl kabul edilir?
Başarılı işlemin yanında başarısız, eksik ve tekrarlanan örnekler denenir. İşletim belgesi; erişim sorumlusu, kayıtların konumu, sağlayıcı değişiklikleri ve bakım yöntemini açıklamalıdır.
Bağlanacak sistemleri ve örnek akışınızı API entegrasyon hizmeti kapsamında değerlendirebilirsiniz.
İlgili kaynaklar
Resmî kaynaklar
Teknik belgeler ve mevzuat değişebilir; uygulama öncesinde ilgili sürüm ve güncel metin kontrol edilmelidir.
Sık Sorulan Sorular
Her API her veriyi aktarmaya izin verir mi?
Hayır. Sağlayıcının sunduğu uç noktalar, yetkiler ve sözleşme koşulları kontrol edilmelidir.
Hazır bağlantı ile özel API geliştirme aynı iş mi?
Mevcut bağlayıcıyı yapılandırmak ve yeni iş kuralları geliştirmek farklı kapsam ve bakım gerektirir.