API Entegrasyonları: Yüksek Seviyeli Bir Bakış ve Uygulamalı Rehber

Günümüzün dijital dünyasında, işletmelerin ve uygulamaların birbiriyle sorunsuz bir şekilde iletişim kurabilmesi hayati önem taşıyor. Farklı sistemler arasındaki manuel veri aktarımı, zaman kaybına, hatalara ve verimsizliğe yol açabilir. Peki, bu karmaşık entegrasyon zorluklarının üstesinden nasıl gelinebilir ve iş süreçleri nasıl otomatikleştirilebilir? İşte tam da bu noktada API entegrasyonları devreye giriyor.

API (Application Programming Interface), yani Uygulama Programlama Arayüzü, temel olarak farklı yazılım sistemlerinin birbiriyle konuşmasını sağlayan bir köprü görevi görür. Bunu bir restoran benzetmesiyle açıklayabiliriz: Siz (uygulamanız) menüden (API dokümantasyonu) bir yemek (veri veya hizmet) seçersiniz, garson (API) bu isteği mutfağa (başka bir sistem) iletir, mutfak yemeği hazırlar ve garson size geri getirir (API yanıtı). Siz mutfağın iç işleyişini bilmek zorunda kalmadan istediğiniz hizmeti alırsınız. Bu benzetme, API’lerin soyutlama prensibini ve kullanım kolaylığını mükemmel bir şekilde yansıtır.

Peki, API entegrasyonları işletmeler için neden bu kadar kritik? Cevap oldukça basit: Dijital dönüşüm ve rekabet gücü. Artık hiçbir işletme izole bir adada yaşayamaz. Müşteri verileri CRM sistemlerinde, stok bilgileri ERP’de, ödeme verileri finansal yazılımlarda ve pazarlama verileri e-posta otomasyon araçlarında dağınık halde bulunabilir. Bu sistemleri bir araya getirmek, işletmelere eşsiz fırsatlar sunar:

• Verimlilik Artışı: Manuel veri girişi ve transferi hatalara açık ve zaman alıcıdır. API entegrasyonları, tekrarlayan görevleri otomatikleştirerek çalışanların daha stratejik işlere odaklanmasını sağlar. Örneğin, bir e-ticaret siparişi otomatik olarak muhasebe sistemine aktarılabilir.
• Gelişmiş Müşteri Deneyimi: Müşterileriniz farklı kanallardan sizinle etkileşimde bulunabilir. Entegre sistemler sayesinde, bir müşterinin tüm geçmişi (satın almalar, destek talepleri, iletişimler) tek bir yerden görüntülenebilir. Bu, kişiselleştirilmiş hizmet ve daha tutarlı bir deneyim sunar.
• Yeni İş Modelleri ve Gelir Akışları: API’lar, üçüncü taraf geliştiricilerin sizin platformunuz üzerinde yeni uygulamalar veya hizmetler oluşturmasına olanak tanır. Bu “API ekonomisi”, yeni gelir kapıları açarken aynı zamanda ekosisteminizi genişletir. Örneğin, bir harita servisi API’si kullanarak kendi navigasyon uygulamanızı zenginleştirebilirsiniz.
• Veri Analizi ve Karar Alma: Farklı kaynaklardan gelen verileri birleştirerek daha kapsamlı analizler yapabilirsiniz. Bu, daha bilinçli iş kararları almanıza ve pazar trendlerini daha iyi anlamanıza yardımcı olur. Entegre satış ve pazarlama verileri, kampanyaların etkinliğini daha net gösterir.
• Ölçeklenebilirlik ve Esneklik: İşletmeniz büyüdükçe, yeni sistemlere veya servislere ihtiyaç duyabilirsiniz. API’ler, mevcut altyapınızı bozmadan yeni teknolojileri entegre etmenizi kolaylaştırır. Bu, işinizin geleceğe yönelik esnekliğini artırır.

Özetle, API entegrasyonları, modern işletmelerin dijital sinir sistemi gibidir. Doğru yapıldığında, operasyonları hızlandırır, maliyetleri düşürür ve rekabet avantajı sağlar. Ancak bu entegrasyonları gerçekleştirirken dikkatli olmak ve doğru stratejiyi belirlemek esastır. Hangi API türünü seçeceğiniz, kimlik doğrulama süreçleri, hata yönetimi ve güvenlik gibi konular, başarılı bir entegrasyonun temel taşlarıdır. Bu makalede, bu temel kavramları ve entegrasyon süreçlerinin yüksek seviyeli bir dökümünü adım adım inceleyeceğiz.

API Türleri ve Protokolleri: Hangi Seçenek Ne Zaman Kullanılmalı?

API entegrasyonlarına başlarken karşımıza çıkan en önemli sorulardan biri, hangi API mimarisi veya protokolünün kullanılacağıdır. Her birinin kendine özgü avantajları ve kullanım senaryoları bulunur. Doğru seçimi yapmak, projenizin başarısını doğrudan etkiler. İşte en yaygın API türleri ve protokolleri:

REST (Representational State Transfer) API’lar: Web’in Omurgası

REST, günümüzde en yaygın kullanılan API mimarisi stilidir. Hafifliği, ölçeklenebilirliği ve web standartlarına uyumu sayesinde, web tabanlı uygulamaların ve mobil uygulamaların birçoğunda tercih edilir. REST API’ler, kaynak (resource) odaklıdır ve HTTP metotlarını (GET, POST, PUT, DELETE) kullanarak bu kaynaklar üzerinde işlemler yapar. Örneğin, bir kullanıcı (kaynak) verisini almak için GET, yeni bir kullanıcı oluşturmak için POST kullanılır.

• Temel Özellikleri:
  • Kaynaksal: Her şey bir kaynak olarak kabul edilir ve benzersiz bir URL (URI) ile temsil edilir.
  • Durumsuz (Stateless): Her istek, sunucunun önceki istek hakkında hiçbir bilgi tutmadığı bağımsız bir işlemdir. Bu, ölçeklenebilirliği artırır.
  • HTTP Metotları: GET (veri al), POST (veri oluştur), PUT (veri güncelle), DELETE (veri sil).
  • Veri Formatları: Genellikle JSON (JavaScript Object Notation) kullanılır, ancak XML (Extensible Markup Language) de desteklenir. JSON, daha hafif ve okunabilir olduğu için daha popülerdir.
• Ne Zaman Kullanılmalı?
  • Mobil uygulamalar, web uygulamaları ve genel internet tabanlı servisler.
  • Yüksek performans ve ölçeklenebilirliğin önemli olduğu durumlar.
  • Basit ve esnek bir mimariye ihtiyaç duyulduğunda.

Bir REST API isteği örneği:

    GET /api/v1/kullanicilar/123
    Host: api.ornek.com
    Authorization: Bearer [ACCESS_TOKEN]
    Accept: application/json
    

Bu istek, 'ornek.com' adresindeki API'nin 'v1' sürümünden '123' ID'li kullanıcıyı JSON formatında talep etmektedir.

SOAP (Simple Object Access Protocol) API'lar: Kurumsal Güvenilirlik

SOAP, daha eski ve daha katı bir protokoldür. Genellikle kurumsal düzeyde ve daha karmaşık entegrasyon senaryolarında, özellikle de güvenlik, işlem yönetimi ve resmi standartlara uyumun ön planda olduğu durumlarda tercih edilir. XML tabanlıdır ve genellikle HTTP, SMTP veya TCP gibi çeşitli taşıma protokolleri üzerinden çalışır.

• Temel Özellikleri:
  • XML Tabanlı: Mesajlaşma formatı tamamen XML'dir. Bu, daha ayrıntılı ve yapılandırılmış mesajlara izin verir.
  • WSDL (Web Services Description Language): API'nin tüm fonksiyonlarını, parametrelerini ve dönüş tiplerini açıklayan bir tanım dilidir. Bu, istemci tarafında otomatik kod üretimi (stub generation) için kullanılır.
  • Daha Güçlü Güvenlik: WS-Security gibi yerleşik standartları sayesinde daha gelişmiş güvenlik özellikleri sunar.
  • İşlem Yönetimi (Transactions): ACID özellikli işlemler için daha uygun bir yapıya sahiptir.
• Ne Zaman Kullanılmalı?
  • Büyük kurumsal uygulamalar (örneğin finans, sigorta, sağlık sektörleri).
  • Dağıtılmış ortamlar ve karmaşık iş akışları.
  • Güvenliğin, güvenilirliğin ve işlem bütünlüğünün kritik olduğu durumlar.
  • Microsoft ve SAP gibi köklü sistemlerle entegrasyonlar.

GraphQL: Esnek ve Verimli Veri Çekme

Facebook tarafından geliştirilen GraphQL, API'lerden veri çekme şeklimizi devrim niteliğinde değiştiren bir sorgu dilidir. REST'in aksine, GraphQL tek bir endpoint üzerinden çalışır ve istemcinin tam olarak hangi veriye ihtiyacı olduğunu belirlemesine olanak tanır. Bu, gereksiz veri transferini azaltır ve birden fazla REST isteğiyle çözülebilecek sorunları tek bir istekte çözebilir.

• Temel Özellikleri:
  • Tek Endpoint: Tüm sorgular tek bir URL'ye yapılır.
  • İstemci Kontrollü Veri Çekme: İstemci, ihtiyaç duyduğu alanları (fields) belirterek sunucudan sadece o verileri alır. Bu, "over-fetching" (gereğinden fazla veri çekme) ve "under-fetching" (gereğinden az veri çekme) sorunlarını çözer.
  • Şema Tabanlı: API'nin sahip olduğu tüm veri tiplerini ve sorgu yapılarını tanımlayan güçlü bir tip sistemi (şema) vardır.
  • Gerçek Zamanlı Veriler (Subscriptions): WebSocket üzerinden gerçek zamanlı veri akışı sağlayabilir.
• Ne Zaman Kullanılmalı?
  • Mobil uygulamalar gibi bant genişliğinin kısıtlı olduğu ortamlar.
  • Birden fazla kaynaktan veri birleştirmesi gereken karmaşık kullanıcı arayüzleri.
  • Hızlı geliştirme ve prototipleme ihtiyacı olan projeler.
  • Mikroservis mimarisinde, farklı servislerden gelen verileri birleştirmek için bir "API Gateway" olarak kullanılabilir.

Bir GraphQL sorgusu örneği:

    query GetUserAndPosts {
      user(id: "123") {
        name
        email
        posts {
          title
          content
        }
      }
    }
    

Webhooks: Anlık Bildirimler ve Gerçek Zamanlı Entegrasyonlar

Webhooks, API'lerin "geri çağrıları" olarak düşünebilirsiniz. Geleneksel API'ler genellikle istemcinin sunucuya istek göndermesini (polling) gerektirirken, webhook'lar bir olay meydana geldiğinde sunucunun istemciye veri göndermesini sağlar. Bu, gerçek zamanlı entegrasyonlar için idealdir.

• Temel Özellikleri:
  • Olay Tabanlı: Belirli bir olay tetiklendiğinde (örneğin, yeni bir ödeme, stok güncellemesi), sunucu önceden tanımlanmış bir URL'ye HTTP POST isteği gönderir.
  • Gerçek Zamanlı: Polling'in aksine, anında bildirim sağlar ve gecikmeyi azaltır.
  • Basit Kurulum: Genellikle bir URL belirtmek ve hangi olayları dinleyeceğinizi seçmek yeterlidir.
• Ne Zaman Kullanılmalı?
  • Ödeme ağ geçitlerinden anlık ödeme bildirimleri almak.
  • Git depolarında (GitHub, GitLab) kod commit'lerinde CI/CD tetiklemek.
  • CRM'de yeni bir potansiyel müşteri oluşturulduğunda e-posta pazarlama sistemini bilgilendirmek.
  • SaaS ürünleri arasında gerçek zamanlı veri senkronizasyonu.

Her bir API türü, farklı ihtiyaçlara ve senaryolara uygun çözümler sunar. Projenizin gereksinimlerini (performans, güvenlik, veri karmaşıklığı, geliştirme hızı) dikkatlice değerlendirerek en uygun seçimi yapmanız, başarılı bir entegrasyonun ilk adımıdır. Çoğu modern uygulama, esneklik ve hızlı geliştirme avantajları nedeniyle REST veya GraphQL'i tercih ederken, bazı kurumsal ortamlar hala SOAP'un sağlam yapısına ihtiyaç duyar.

Adım Adım API Entegrasyon Süreci: Başarılı Bir Entegrasyon İçin Nasıl Bir Yol İzlemelisiniz?

API entegrasyonu, sadece kod yazmaktan ibaret değildir; dikkatli planlama, doğru araçları seçme ve olası sorunlara karşı hazırlıklı olmayı gerektiren çok aşamalı bir süreçtir. İşte başarılı bir API entegrasyonu için izlemeniz gereken adımlar:

1. Planlama ve API Dokümantasyonunu Anlama

Her entegrasyon projesinin başlangıç noktası, neyi entegre edeceğinizi ve neden ettiğinizi net bir şekilde anlamaktır. Hedeflerinizi belirleyin (örneğin, "X sisteminden Y sistemine müşteri verilerini aktarmak"). Ardından, entegre edeceğiniz API'nin dokümantasyonunu dikkatlice inceleyin. API dokümantasyonu, bir API'nin nasıl çalıştığını, hangi endpoint'lerin mevcut olduğunu, hangi parametreleri beklediğini, hangi kimlik doğrulama yöntemlerini kullandığını ve hangi hata kodlarını döndürebileceğini açıklayan kılavuzdur. Swagger (OpenAPI) veya Postman koleksiyonları genellikle bu dokümantasyonun standart formatlarıdır.

• Neleri Kontrol Etmelisiniz?
  • Kullanılabilir endpoint'ler ve HTTP metotları (GET, POST, PUT, DELETE).
  • İstek ve yanıt formatları (JSON, XML).
  • Gerekli kimlik doğrulama yöntemleri (API anahtarları, OAuth 2.0).
  • Hız sınırlamaları (Rate Limiting) ve kullanım kotaları.
  • Hata kodları ve anlamları.
  • SDK'lar veya örnek kodlar.

Bu aşamada eksik veya belirsiz gördüğünüz noktalar için API sağlayıcısıyla iletişime geçmekten çekinmeyin.

2. Kimlik Doğrulama (Authentication) ve Yetkilendirme (Authorization)

API'ler genellikle hassas verilere erişim sağladığı için güvenliğin en üst düzeyde olması gerekir. Kimlik doğrulama, API'yi kullanan uygulamanın veya kullanıcının kimliğini doğrulamak, yetkilendirme ise bu kimliği doğrulanmış varlığın hangi kaynaklara erişebileceğini belirlemektir.

• Yaygın Kimlik Doğrulama Yöntemleri:
  • API Anahtarları (API Keys): En basit yöntemdir. Genellikle URL'de bir parametre olarak veya HTTP başlığında gönderilen benzersiz bir dizedir. Kolay ancak gizliliği önemlidir, doğrudan istemci tarafında kullanılmamalıdır.
  • HTTP Basic Auth: Kullanıcı adı ve şifrenin Base64 ile kodlanarak HTTP başlığında gönderilmesi. Nispeten basit ama hassas veriler için HTTPS ile kullanılmalıdır.
  • OAuth 2.0: En yaygın ve güçlü yetkilendirme çerçevesidir. Uygulamanızın, kullanıcının doğrudan kullanıcı adı ve şifresini bilmeden, kullanıcının adına bir API'ye erişim izni almasını sağlar. Sosyal medya entegrasyonları, ödeme sistemleri gibi durumlarda tercih edilir. Access Token ve Refresh Token gibi kavramları içerir.
  • JWT (JSON Web Tokens): Genellikle OAuth 2.0 ile birlikte kullanılır. Güvenli bir şekilde bilgi alışverişi yapmak için kullanılan kompakt, URL'ye uygun ve imzalanmış JSON nesneleridir. Bir kez oluşturulduğunda, sunucu tarafında oturum tutmaya gerek kalmadan kimlik doğrulaması sağlar.

Doğru kimlik doğrulama yöntemini seçmek ve anahtarları/token'ları güvenli bir şekilde saklamak, entegrasyonunuzun güvenliği açısından hayati öneme sahiptir.

    # Python ile API Anahtarı kullanarak basit bir GET isteği örneği
    import requests

    api_key = "YOUR_API_KEY" # Gerçek bir projede bu şekilde doğrudan kodda saklanmamalıdır!
    headers = {
        "Authorization": f"Bearer {api_key}",
        "Accept": "application/json"
    }
    url = "https://api.ornek.com/veriler"

    try:
        response = requests.get(url, headers=headers)
        response.raise_for_status() # HTTP 200 olmayan durum kodları için hata fırlat
        data = response.json()
        print("API Yanıtı:", data)
    except requests.exceptions.HTTPError as err:
        print(f"HTTP Hatası oluştu: {err}")
    except requests.exceptions.RequestException as err:
        print(f"Bir istek hatası oluştu: {err}")
    

3. İstek Yapma ve Yanıtları İşleme

Kimlik doğrulama kurulduktan sonra, API'ye istek göndermeye ve yanıtları işlemeye hazırsınız demektir. Çoğu modern programlama dilinde (Python, Node.js, Java, C#, PHP vb.) HTTP isteklerini kolaylaştıran kütüphaneler bulunur. Yanıtlar genellikle JSON veya XML formatında gelir ve bu verilerin uygulamanızda kullanılabilmesi için ayrıştırılması (parse edilmesi) gerekir.

• Temel Adımlar:
  • HTTP Metodu Seçimi: GET (almak), POST (oluşturmak), PUT (güncellemek), DELETE (silmek).
  • Endpoint Belirleme: İsteği göndereceğiniz URL.
  • Parametre ve Başlıklar: Gerekli query parametreleri, body verileri ve HTTP başlıklarını (Content-Type, Authorization gibi) ekleyin.
  • Yanıtı Almak: İstek başarılı olduktan sonra gelen yanıtı alın.
  • Yanıtı Ayrıştırmak: JSON.parse() veya XML ayrıştırıcıları kullanarak veriyi uygulamanızın anlayacağı bir yapıya dönüştürün.

4. Hata Yönetimi ve Yeniden Denemeler

API entegrasyonlarında hatalar kaçınılmazdır. Ağ sorunları, geçersiz istekler, yetkilendirme hataları veya API hizmetindeki kesintiler gibi birçok şey yanlış gidebilir. Sağlam bir hata yönetimi stratejisi, uygulamanızın beklenmedik durumlarda bile istikrarlı çalışmasını sağlar.

• HTTP Durum Kodları: API yanıtları, isteğin durumunu belirten HTTP durum kodları içerir (örn. 200 OK, 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found, 500 Internal Server Error, 503 Service Unavailable). Bu kodları kontrol ederek hatanın kaynağını anlayabilirsiniz.
• Hata Mesajları: API'ler genellikle durum kodunun yanı sıra hatanın daha ayrıntılı açıklamasını içeren bir hata mesajı da gönderir.
• Yeniden Denemeler (Retries): Özellikle geçici ağ sorunları veya hizmet kesintileri gibi durumlarda, belirli bir gecikmeyle isteği yeniden denemek faydalı olabilir. Exponential Backoff (üstel geri çekilme) stratejisi, her yeniden denemede bekleme süresini artırarak API sunucusunu aşırı yüklemekten kaçınır.
• Loglama: Tüm API isteklerini, yanıtlarını ve hatalarını loglamak, sorun giderme ve izleme açısından kritik öneme sahiptir.

5. Test Etme ve İzleme

Entegrasyonunuzu geliştirdikten sonra kapsamlı bir şekilde test etmek zorunludur. Fonksiyonel testler (doğru veriyi alıyor muyum, doğru işlemi yapıyor muyum?), performans testleri (yük altında nasıl çalışıyor?) ve hata senaryosu testleri (geçersiz girişlerde ne oluyor?) yapılmalıdır. Entegrasyon devreye alındıktan sonra da sürekli izlenmelidir. API Gateway'ler veya özel izleme araçları, API çağrılarını, yanıt sürelerini, hata oranlarını ve kotaları takip etmenize olanak tanır. Bu, potansiyel sorunları proaktif olarak tespit etmenize yardımcı olur.

Bu adımları takip ederek, daha sağlam, güvenli ve sürdürülebilir API entegrasyonları geliştirebilirsiniz. Unutmayın, API entegrasyonları yaşayan sistemlerdir ve zamanla API'lerdeki değişikliklere veya iş gereksinimlerindeki evrimlere göre güncellenmeleri gerekebilir.

Gerçek Dünya Senaryoları ve Vaka Analizleri: Entegrasyonlar Nasıl Hayat Buluyor?

API entegrasyonlarının teorik faydalarını anlamak harika, ancak bu kavramların gerçek dünyada nasıl somutlaştığını görmek, potansiyellerini tam olarak kavramamıza yardımcı olur. İşte farklı sektörlerden birkaç vaka analizi:

1. E-ticaret Sitesi ve Ödeme Ağ Geçidi Entegrasyonu: Sorunsuz Alışveriş Deneyimi

Senaryo: Bir e-ticaret sitesi, müşterilerinin kredi kartıyla veya diğer çevrimiçi yöntemlerle ödeme yapmasını sağlamak istiyor. Ancak bir ödeme sistemini sıfırdan geliştirmek, yüksek güvenlik standartları, düzenlemelere uyum ve karmaşık altyapı gerektirdiğinden imkansız denecek kadar zor ve maliyetlidir.

API Çözümü: E-ticaret sitesi, Stripe, Iyzico veya PayTR gibi bir ödeme ağ geçidi sağlayıcısının API'sini entegre eder.

• Müşteri ödeme sayfasına geldiğinde, e-ticaret sitesi arka planda ödeme ağ geçidinin API'sine bir POST isteği göndererek bir ödeme oturumu başlatır veya doğrudan kredi kartı bilgilerini (güvenli bir şekilde) ödeme ağ geçidine iletir.
• API, kart bilgilerini işler, bankayla iletişime geçer ve işlemin başarılı olup olmadığını belirten bir yanıt (HTTP 200 OK, 400 Bad Request vb.) döndürür.
• Başarılı bir ödeme durumunda, ödeme ağ geçidi, e-ticaret sitesinin önceden tanımladığı bir webhook URL'sine anlık bildirim (HTTP POST isteği) gönderir. Bu bildirim sayesinde, e-ticaret sitesi siparişi onaylar, stokları günceller ve müşteriye bir onay e-postası gönderir.

Faydaları:

• Güvenlik: Hassas kredi kartı bilgileri doğrudan e-ticaret sitesinin sunucularında işlenmez, bu da PCI DSS gibi güvenlik standartlarına uyumu kolaylaştırır.
• Geniş Ödeme Seçenekleri: Tek bir entegrasyonla birden fazla ödeme yöntemini (kredi kartı, banka kartı, mobil ödemeler) sunabilme.
• Otomasyon: Ödeme onayları, sipariş güncellemeleri ve stok yönetimi gibi süreçler otomatikleşir.
• Azaltılmış Geliştirme Maliyeti: Kapsamlı bir ödeme sistemi geliştirme ihtiyacını ortadan kaldırır.

2. CRM ve E-posta Pazarlama Otomasyonu Entegrasyonu: Kişiselleştirilmiş İletişim

Senaryo: Bir işletme, potansiyel müşteri (lead) bilgilerini Salesforce gibi bir CRM sisteminde yönetiyor. Aynı zamanda Mailchimp veya SendGrid gibi bir e-posta pazarlama aracı kullanarak bu potansiyel müşterilere otomatik e-postalar göndermek istiyor. Ancak CRM'deki yeni lead'leri manuel olarak e-posta listesine eklemek zaman alıcı ve hataya açıktır.

API Çözümü: CRM sistemi ile e-posta pazarlama aracı arasında bir API entegrasyonu kurulur.

• CRM sisteminde yeni bir potansiyel müşteri (lead) oluşturulduğunda veya mevcut bir lead'in durumu değiştiğinde (örneğin, "niteliği uygun" olarak işaretlendiğinde), CRM'in API'si aracılığıyla e-posta pazarlama platformunun API'sine bir POST isteği gönderilir.
• Bu istek, yeni lead'in adını, e-postasını ve diğer ilgili bilgilerini e-posta pazarlama platformundaki ilgili bir listeye ekler.
• E-posta pazarlama platformu, bu yeni aboneyi belirli bir otomatik e-posta serisine (örneğin, "hoş geldin e-postaları" veya "ürün tanıtım serisi") dahil eder.
• Benzer şekilde, bir müşteri e-postayı açtığında veya bir bağlantıya tıkladığında, e-posta pazarlama platformu bir webhook ile bu bilgiyi CRM'e geri gönderebilir, böylece müşteri profili güncellenir.

Faydaları:

• Otomatik Senkronizasyon: Verilerin manuel olarak kopyalanmasına gerek kalmaz, hatalar azalır.
• Kişiselleştirilmiş Pazarlama: Müşteri segmentlerine göre otomatik ve hedefli e-posta kampanyaları oluşturulabilir.
• Gelişmiş Veri Görünürlüğü: Pazarlama ve satış ekipleri, müşteri etkileşimleri hakkında daha bütünsel bir görüşe sahip olur.
• Zaman Tasarrufu: Pazarlama ve satış ekipleri, manuel işler yerine strateji geliştirmeye odaklanabilir.

3. Lojistik ve Tedarik Zinciri Takip Entegrasyonu: Şeffaf Kargo Süreçleri

Senaryo: Bir e-ticaret firması, müşterilerine siparişlerinin nerede olduğunu gerçek zamanlı olarak takip etme olanağı sunmak istiyor. Farklı kargo şirketleriyle çalıştığı için her bir kargo şirketinin web sitesini ziyaret etmek veya manuel takip numaraları girmek hem müşteriler hem de firma için verimsizdir.

API Çözümü: E-ticaret firması, anlaşmalı olduğu kargo şirketlerinin (UPS, FedEx, Aras Kargo vb.) takip API'lerini entegre eder.

• Müşteri bir sipariş verdiğinde, e-ticaret sistemi kargo şirketinin API'sine bir istek göndererek bir gönderi etiketi oluşturur ve bir takip numarası alır. Bu numara, sipariş verisiyle birlikte kendi veritabanına kaydedilir.
• Müşteri, sipariş takip sayfasını ziyaret ettiğinde, e-ticaret sitesi arka planda kargo şirketinin takip API'sine takip numarasını içeren bir GET isteği gönderir.
• API, kargonun mevcut konumunu, durumunu (yolda, teslim edildi, gümrükte vb.) ve tahmini teslimat süresini içeren bir yanıt döndürür.
• Bu bilgiler, müşteriye şık bir arayüzle sunulur. Bazı durumlarda, kargo şirketleri belirli bir durum değişikliğinde (örneğin, "teslim edildi") e-ticaret firmasına webhook aracılığıyla da bildirim gönderebilir.

Faydaları:

• Gelişmiş Müşteri Memnuniyeti: Müşteriler, siparişlerini kolayca takip edebilir ve bilgiye anında ulaşır.
• Operasyonel Verimlilik: Müşteri hizmetleri ekibinin "kargom nerede?" sorularıyla harcadığı zaman azalır.
• Tek Merkezden Yönetim: Farklı kargo şirketlerinin verileri tek bir panelde birleştirilebilir.
• Proaktif Sorun Giderme: Potansiyel teslimat sorunları erken tespit edilebilir.

Bu vaka analizleri, API entegrasyonlarının sadece teknik bir gereklilik olmadığını, aynı zamanda işletmelerin verimliliklerini artırmalarına, maliyetlerini düşürmelerine ve müşterilerine daha iyi hizmet sunmalarına olanak tanıyan stratejik araçlar olduğunu açıkça göstermektedir. Her entegrasyon, iş süreçlerindeki bir boşluğu doldurur ve sistemler arasındaki iletişimi güçlendirir.

Güvenlik ve Performans Optimizasyonu: Entegrasyonlarınızı Nasıl Korur ve Hızlandırırsınız?

API entegrasyonlarının başarılı olması için sadece çalışması yeterli değildir; aynı zamanda güvenli ve hızlı olması da gerekir. Güvenlik açıkları veri ihlallerine yol açabilirken, performans sorunları kullanıcı deneyimini olumsuz etkileyebilir ve iş süreçlerini yavaşlatabilir. Bu bölümde, entegrasyonlarınızı korumak ve optimize etmek için almanız gereken önlemleri inceleyeceğiz.

API Entegrasyonlarında Güvenlik

API'ler, sistemleriniz arasındaki kapılar gibidir. Bu kapıları açık bırakmak veya zayıf kilitlerle korumak, istenmeyen erişimlere davetiye çıkarmaktır. İşte güvenlik için dikkat etmeniz gerekenler:

• Taşıma Katmanı Güvenliği (HTTPS/SSL/TLS): Tüm API iletişimleri HTTPS üzerinden yapılmalıdır. Bu, verilerin şifreli olarak iletilmesini sağlar ve "ortadaki adam" (man-in-the-middle) saldırılarını önler. Asla HTTP üzerinden hassas veri göndermeyin.
• Güçlü Kimlik Doğrulama ve Yetkilendirme Mekanizmaları:
  • API Anahtarları: Eğer API anahtarları kullanıyorsanız, bunları doğrudan istemci tarafı kodunda (web tarayıcısı, mobil uygulama) saklamayın. Arka uç sunucunuzda güvenli bir şekilde saklayın ve API çağrılarını arka uçtan yapın. Anahtarları düzenli olarak yenileyin.
  • OAuth 2.0: Hassas kullanıcı verilerine erişim gerektiren durumlar için OAuth 2.0, en iyi uygulamadır. Token'ların ömrünü sınırlı tutun (kısa ömürlü access token'lar ve uzun ömürlü refresh token'lar kullanın).
  • JWT (JSON Web Tokens): JWT kullanırken, token'ları güvenli bir şekilde imzalamak için güçlü algoritmalar ve gizli anahtarlar kullanın. Token'ların süresinin dolmasına dikkat edin ve gerekirse iptal mekanizmaları uygulayın.
• Giriş Doğrulama ve Temizleme: API'nize gelen tüm giriş verilerini (parametreler, istek gövdesi) her zaman doğrulayın ve temizleyin. SQL enjeksiyonu, XSS (Cross-Site Scripting) veya kötü niyetli veri girişleri gibi saldırıları önlemek için beklenmeyen veya kötü amaçlı girişleri reddedin.
• Hız Sınırlama (Rate Limiting): Bir istemcinin belirli bir zaman diliminde yapabileceği istek sayısını sınırlayın. Bu, hizmet reddi (DoS) saldırılarını veya API'nizin aşırı yüklenmesini önler. Ayrıca, API kötüye kullanımını da zorlaştırır.
• Erişim Kontrolü (Access Control): Kullanıcıların ve uygulamaların yalnızca ihtiyaç duydukları kaynaklara erişmesini sağlayın. Rol tabanlı erişim kontrolü (RBAC) veya nitelik tabanlı erişim kontrolü (ABAC) uygulayın.
• Güvenli Loglama: Log dosyalarına hassas bilgileri (şifreler, kredi kartı numaraları) kaydetmekten kaçının. Eğer kaydetmeniz gerekiyorsa, şifreleme veya maskeleme yöntemleri kullanın.
• Güvenlik Denetimleri ve Penetrasyon Testleri: Entegrasyonlarınızı düzenli olarak güvenlik açıklarına karşı denetleyin ve sızma testleri (penetration tests) yapın.

API Entegrasyonlarında Performans Optimizasyonu

Hızlı yanıt süreleri ve verimli kaynak kullanımı, API entegrasyonlarının kullanıcı deneyimi ve maliyeti açısından kritik önem taşır. İşte performans artırıcı stratejiler:

• Önbellekleme (Caching): Sıkça istenen ve nadiren değişen veriler için önbellekleme kullanın. İstemci tarafında, ara sunucularda veya API ağ geçitlerinde önbellekleme uygulayabilirsiniz. Bu, API'ye yapılan gereksiz çağrıları azaltır ve yanıt sürelerini önemli ölçüde hızlandırır.
  Uzman İpucu: Önbellek stratejisi belirlerken verinin güncelliği (TTL - Time To Live) ve tutarlılığı arasında bir denge kurmanız gerekir. Çok agresif önbellekleme bayat verilere yol açabilir.
• Asenkron İşlemler: Uzun süreli veya karmaşık işlemleri (örneğin, büyük dosyaların işlenmesi, toplu veri içe aktarımı) senkron olarak yapmak yerine asenkron olarak gerçekleştirin. Bu, API çağrısının hemen yanıt vermesini sağlar ve işlemin arka planda tamamlanmasına izin verir. Webhooks veya callback URL'leri ile işlemin tamamlandığı bildirilebilir.
• Verimli Veri Aktarımı:
  • Sadece İhtiyaç Duyulan Veriyi İsteyin: GraphQL gibi araçlar, istemcinin tam olarak hangi alanlara ihtiyacı olduğunu belirtmesini sağlar. REST API'lerde de benzer şekilde "field selection" veya "sparse fieldsets" gibi özellikler sunulabilir.
  • Sıkıştırma: HTTP sıkıştırmayı (gzip gibi) kullanarak aktarılan veri boyutunu küçültün, bu da bant genişliği kullanımını azaltır ve yanıt sürelerini hızlandırır.
  • Sayfalandırma (Pagination): Büyük veri setlerini tek seferde almak yerine, sayfalandırma (örneğin, ?page=1&limit=100) kullanarak veriyi parçalara ayırın. Bu, sunucu yükünü ve yanıt boyutunu azaltır.
• Yük Dengeleme (Load Balancing): Gelen API isteklerini birden fazla sunucuya dağıtarak tek bir sunucunun aşırı yüklenmesini önleyin ve uygulamanızın ölçeklenebilirliğini artırın.
• API Gateway Kullanımı: API Gateway'ler, API yönetimini merkezileştirir ve hız sınırlama, önbellekleme, kimlik doğrulama, izleme gibi birçok performans ve güvenlik özelliğini tek bir yerden yönetmenizi sağlar.
• Ağ Yapısını Optimize Etme: API sunucularınızın coğrafi konumunu hedef kitlenize yakın tutun (CDN - İçerik Dağıtım Ağı kullanarak) ve düşük gecikme süreli ağ bağlantıları sağlayın.

Güvenlik ve performans, bir API entegrasyonunun sadece "ekstraları" değil, temel bileşenleridir. Bu alanlara yatırım yapmak, uzun vadede uygulamanızın sağlamlığını, kullanıcı memnuniyetini ve maliyet etkinliğini artıracaktır. Sürekli izleme ve düzenli güvenlik denetimleri, bu optimizasyonların sürdürülebilirliğini sağlamak için vazgeçilmezdir.

İleri Düzey İpuçları ve En İyi Uygulamalar: Profesyonel Entegrasyonlar İçin Ne Yapmalı?

API entegrasyonlarının temel prensiplerini ve süreçlerini anladığımıza göre, şimdi bu alanda deneyimli geliştiricilerin kullandığı bazı ileri düzey tekniklere ve en iyi uygulamalara göz atalım. Bu ipuçları, entegrasyonlarınızın daha sürdürülebilir, ölçeklenebilir ve yönetilebilir olmasını sağlayacaktır.

1. Sürümleme (Versioning) Stratejileri

API'ler zamanla değişir ve gelişir. Yeni özellikler eklenir, mevcut endpoint'ler güncellenir veya kaldırılır. Bu değişiklikleri yönetmek için sürümleme kritik öneme sahiptir. Sürümleme olmadan, API'deki bir değişiklik, bu API'yi kullanan tüm entegrasyonları bozabilir. İşte yaygın sürümleme yaklaşımları:

• URI Sürümleme (Path Versioning): En yaygın yöntemdir. API sürümünü URL yoluna dahil etmek (örneğin, /api/v1/kullanicilar veya /api/v2/kullanicilar). Bu, farklı sürümlerin aynı anda yayında olmasına izin verir.
• Query Parametre Sürümleme: Sürümü bir sorgu parametresi olarak eklemek (örneğin, /api/kullanicilar?version=1).
• Header Sürümleme: Sürümü HTTP başlıklarında (örneğin, Accept-Version: v1) belirtmek.
• Medya Türü Sürümleme (Content Negotiation): HTTP Accept başlığında özel bir medya türü belirterek sürümü kontrol etmek (örneğin, Accept: application/vnd.ornekapi.v1+json).

En İyi Uygulama: URI sürümleme genellikle en açık ve yönetilebilir yöntem olarak kabul edilir. Yeni bir sürüm yayınladığınızda, eski sürümleri belirli bir süre daha desteklemeye devam edin ve kullanıcıları yeni sürüme geçmeleri konusunda bilgilendirin.

2. API Gateway Kullanımı

Birden fazla API ile veya mikroservis mimarisiyle çalışırken bir API Gateway kullanmak, yönetimi ve güvenliği önemli ölçüde basitleştirir. API Gateway, tüm dış API istekleri için tek bir giriş noktası görevi görür.

• Faydaları:
  • Merkezi Kimlik Doğrulama ve Yetkilendirme: Tüm API'ler için kimlik doğrulama ve yetkilendirme logic'ini tek bir yerde yönetebilirsiniz.
  • Yönlendirme (Routing): Gelen istekleri doğru mikroservislere veya arka uç API'lerine yönlendirir.
  • Hız Sınırlama ve Önbellekleme: Performans ve güvenlik politikalarını merkezi olarak uygulayabilirsiniz.
  • İzleme ve Loglama: Tüm API trafiğini izleyebilir ve loglayabilirsiniz.
  • Dönüşüm: Geleneksel API'leri (örneğin REST) alıp, dahili olarak farklı protokollere (örneğin gRPC) dönüştürebilir.

Yukarıdaki örnekler, bir API Gateway ile doğrudan ilgili olmasa da, modern web uygulamalarının ve dolayısıyla API entegrasyonlarının da temelinde yatan mobil uyumluluk ve esnek tasarım ilkelerini göstermektedir. Bir API Gateway, mobil uygulamaların farklı cihazlara uygun API yanıtları almasını sağlamak için dönüşümler yapabilir.

3. Idempotent İstekler

Bir API isteğinin "idempotent" olması, aynı isteği birden fazla kez göndermenin, tek bir kez göndermenin etkisiyle aynı olması anlamına gelir. Özellikle ağ hataları veya zaman aşımı durumlarında isteği yeniden denemeniz gerektiğinde bu çok önemlidir. Örneğin, bir ödeme isteği idempotent değilse, aynı işlemi birden fazla kez tetikleyerek mükerrer ödemelere yol açabilir.

• Nasıl Uygulanır?
  • POST istekleri genellikle idempotent değildir. Ancak, bir benzersiz anahtar (Idempotency-Key başlığı gibi) kullanarak aynı isteğin sadece bir kez işlenmesini sağlayabilirsiniz.
  • GET, PUT ve DELETE istekleri genellikle tasarım gereği idempotenttir.

4. Kapsamlı Test Stratejisi

API entegrasyonları, birçok hareketli parçaya sahip karmaşık sistemlerdir. Bu nedenle, kapsamlı bir test stratejisi olmazsa olmazdır.

• Birim Testleri (Unit Tests): API istemci kodunuzun doğru çalıştığından emin olun.
• Entegrasyon Testleri (Integration Tests): Uygulamanızın API ile doğru şekilde etkileşim kurduğunu test edin. Gerçek API'ye veya sahte (mock) API'lere karşı test yapabilirsiniz.
• Uçtan Uca Testler (End-to-End Tests): Tüm iş akışını test edin, örneğin bir siparişin oluşturulmasından ödeme ve sevkiyata kadar.
• Performans ve Yük Testleri: API'nizin beklenen yük altında nasıl davrandığını ve yanıt sürelerinin kabul edilebilir sınırlar içinde olup olmadığını kontrol edin.
• Hata Senaryosu Testleri: API'nin hata durumlarında (geçersiz kimlik bilgileri, hız sınırlaması, sunucu hataları) nasıl yanıt verdiğini test edin.

5. İzleme (Monitoring) ve Loglama (Logging)

Entegrasyonlar devreye alındıktan sonra da yaşamaya devam eder. Herhangi bir sorun olduğunda bunu hızlıca tespit edebilmek için kapsamlı izleme ve loglama sistemleri kurmanız gerekir.

• İzleme: API çağrı sayısını, yanıt sürelerini, hata oranlarını, kullanılan kotaları ve genel sistem sağlığını izleyin. Prometheus, Grafana, Datadog gibi araçlar bu konuda size yardımcı olabilir. Anormallikler veya eşikler aşıldığında uyarılar almalısınız.
• Loglama: API isteklerini, yanıtlarını (hassas verileri maskeleyerek), hata mesajlarını ve uygulamanızdaki ilgili olayları detaylı olarak loglayın. Merkezi bir loglama sistemi (ELK Stack - Elasticsearch, Logstash, Kibana, Splunk gibi) kullanarak logları kolayca arayabilir, analiz edebilir ve sorunları giderebilirsiniz.

6. SDK Kullanımı ve Kütüphaneler

Eğer entegre ettiğiniz API popülerse, genellikle sağlayıcı tarafından resmi bir SDK (Software Development Kit) sunulur. Bir SDK kullanmak, kimlik doğrulama, istek oluşturma, yanıtları ayrıştırma ve hata yönetimi gibi birçok standart işlemi sizin için hallettiğinden entegrasyon sürecini büyük ölçüde hızlandırır ve basitleştirir.

Bu ileri düzey ipuçları ve en iyi uygulamalar, API entegrasyonlarınızı sadece "çalışır" olmaktan çıkarıp, "sağlam, güvenli, ölçeklenebilir ve yönetilebilir" bir yapıya kavuşturmanıza yardımcı olacaktır. Dijital dünyada rekabetçi kalmak için API entegrasyonlarına yapılan yatırımın doğru stratejilerle desteklenmesi hayati öneme sahiptir.

Sonuç: API Entegrasyonları Geleceğimizi Nasıl Şekillendiriyor?

API entegrasyonları, modern yazılım geliştirmelerinin ve dijital işletmelerin vazgeçilmez bir parçası haline gelmiştir. Artık uygulamaların ve hizmetlerin kapalı kutular içinde işlev görmesi değil, birbiriyle sürekli ve anlamlı bir iletişim kurması bekleniyor. Bu makalede ele aldığımız gibi, API'ler sadece teknik bir kavram olmanın ötesinde, işletmelerin verimliliklerini artırmalarını, yeni iş modelleri geliştirmelerini, müşteri deneyimlerini zenginleştirmelerini ve rekabet avantajı elde etmelerini sağlayan stratejik araçlardır.

REST, SOAP, GraphQL gibi farklı API türlerini anlamak, her birinin kendine özgü güçlü yönleri ve kullanım senaryoları olduğunu kavramak, doğru entegrasyon mimarisini seçmenin ilk adımıdır. Ardından, detaylı bir planlama, güvenli kimlik doğrulama mekanizmaları, sağlam hata yönetimi ve sürekli test-izleme süreçleriyle desteklenen adım adım bir entegrasyon süreci izlenmelidir. Gerçek dünya senaryoları ve vaka analizleri, ödeme sistemlerinden CRM otomasyonlarına, lojistik takipten bulut bilişime kadar API'lerin dönüştürücü gücünü somut bir şekilde gözler önüne sermiştir.

Güvenlik ve performans optimizasyonu, başarılı bir API entegrasyonunun sadece çalışmasını değil, aynı zamanda güvenilir ve verimli olmasını garantileyen temel unsurlardır. HTTPS kullanımı, güçlü kimlik doğrulama, hız sınırlama, önbellekleme ve asenkron işlemler gibi teknikler, sistemlerinizi korurken kullanıcı deneyimini de iyileştirir. Son olarak, sürümleme, API Gateway'ler, idempotent istekler ve kapsamlı izleme gibi ileri düzey uygulamalar, entegrasyon projelerinizin uzun vadeli sürdürülebilirliğini ve yönetilebilirliğini sağlar.

Dijital dönüşümün hızı arttıkça, API'lerin önemi de artmaya devam edecektir. Mikroservis mimarileri, sunucusuz (serverless) teknolojiler ve yapay zeka entegrasyonları gibi geleceğin teknolojileri, API'ler aracılığıyla bir araya gelmektedir. Bu nedenle, API entegrasyon yetkinliklerini geliştirmek, hem bireysel geliştiriciler hem de işletmeler için geleceğe yönelik kritik bir yatırımdır. Unutmayın, entegrasyon bir defalık bir görev değil, sürekli öğrenme, adaptasyon ve iyileştirme gerektiren dinamik bir yolculuktur.

Sıkça Sorulan Sorular (SSS)

1. API entegrasyonu ne kadar sürer?

API entegrasyonunun süresi, entegre edilecek API'nin karmaşıklığına, dokümantasyonun kalitesine, geliştirme ekibinin deneyimine ve iş gereksinimlerinin detayına göre büyük ölçüde değişir. Basit bir entegrasyon birkaç gün sürebilirken, kapsamlı ve çok sayıda endpoint içeren karmaşık entegrasyonlar haftalar veya aylar alabilir. Kimlik doğrulama yönteminin karmaşıklığı, veri dönüşüm ihtiyacı ve hata yönetimi de süreyi etkileyen faktörlerdendir.

2. REST API mi SOAP API mi tercih etmeliyim?

Tercihiniz projenizin özel gereksinimlerine bağlıdır.

• REST API: Genellikle mobil uygulamalar, web uygulamaları ve hafif, esnek, ölçeklenebilir ve hızlı geliştirme gerektiren projeler için idealdir. JSON veri formatını kullanır ve web standartlarına daha yakındır.
• SOAP API: Genellikle kurumsal düzeyde uygulamalar, finans, sağlık gibi sektörlerde güvenlik, işlem bütünlüğü ve sıkı standartlara uyumun ön planda olduğu durumlar için tercih edilir. XML tabanlıdır ve daha karmaşık bir yapıya sahiptir.

Günümüzde çoğu yeni entegrasyon REST'i tercih ederken, bazı eski veya belirli kurumsal sistemlerle entegrasyonlar için SOAP hala geçerliliğini korumaktadır. GraphQL ise, istemcinin veri çekme esnekliği ihtiyacı olduğunda harika bir alternatiftir.

3. API anahtarlarımı nasıl güvende tutarım?

API anahtarları, sisteminize erişim sağlayan kimlik bilgileridir ve son derece gizli tutulmalıdır:

• Doğrudan Koda Gömme: Asla API anahtarlarınızı doğrudan istemci tarafı kodunuza (JavaScript, mobil uygulama kaynak kodu) gömmeyin.
• Sunucu Tarafı Kullanım: API çağrılarını her zaman arka uç sunucunuzdan yapın ve anahtarları sunucu tarafında güvenli bir şekilde saklayın (çevre değişkenleri, güvenli konfigürasyon dosyaları, sır yönetim hizmetleri).
• Sürüm Kontrolünden Hariç Tutma: Anahtar dosyalarını (.env, config.ini) Git gibi sürüm kontrol sistemlerinden hariç tutun (.gitignore kullanarak).
• Erişim Kısıtlama: Anahtarların saklandığı yerlere fiziksel ve yazılımsal erişimi kısıtlayın.
• Düzenli Yenileme: Güvenliği artırmak için anahtarları düzenli aralıklarla yenileyin.

4. Entegrasyon hatalarını nasıl gideririm?

Hata giderme süreci sistematik bir yaklaşımla kolaylaşır:

• API Dokümantasyonunu Kontrol Edin: Aldığınız hata kodunu ve mesajını API dokümantasyonunda arayın.
• Logları İnceleyin: Kendi uygulamanızın ve varsa API Gateway'in loglarını kontrol edin. İstek ve yanıt detayları, hata mesajları genellikle burada bulunur.
• HTTP Durum Kodları: 4xx (istemci hatası) veya 5xx (sunucu hatası) kodlarına dikkat edin. 401 Unauthorized, 403 Forbidden gibi hatalar kimlik doğrulama/yetkilendirme sorunlarına işaret ederken, 400 Bad Request genellikle yanlış formatta veri gönderdiğinizi gösterir.
• İstek Verilerini Doğrulayın: Gönderdiğiniz istek parametrelerinin ve gövdesinin API'nin beklediği format ve tiplerle eşleştiğinden emin olun.
• Ağ Bağlantısını Kontrol Edin: Kendi sunucunuzun veya uygulamanızın API'ye erişip erişemediğini doğrulayın.
• Tekrar Deneme Mantığı: Geçici hatalar için yeniden deneme mekanizmalarınızın doğru çalıştığından emin olun.

5. Bir API entegrasyonu için hangi programlama dillerini kullanabilirim?

API entegrasyonları, neredeyse tüm modern programlama dilleriyle yapılabilir. Önemli olan, dilin HTTP istekleri yapma, JSON/XML ayrıştırma ve veri işleme yeteneklerine sahip olmasıdır. En popüler dillerden bazıları şunlardır:

• Python: Basit sözdizimi ve güçlü HTTP kütüphaneleri (requests) sayesinde çok tercih edilir.
• JavaScript (Node.js): Sunucu tarafı uygulamalar için idealdir, özellikle web tabanlı API'lerle sıkı entegrasyon gerektiren projelerde.
• Java: Kurumsal düzeyde uygulamalar ve sağlam entegrasyonlar için yaygın olarak kullanılır.
• C# (.NET): Microsoft ekosistemindeki uygulamalar için güçlü bir seçenektir.
• PHP: Web tabanlı entegrasyonlar için popülerdir, özellikle WordPress gibi CMS'lerle birlikte.

Seçiminiz, mevcut projenizin teknolojisine, geliştirme ekibinizin uzmanlığına ve API sağlayıcısının sunduğu SDK'lara bağlı olacaktır.