API geliştirme için teknoloji seçimi (Efeler)

01Kullanılabilecek teknolojiler

REST API

HTTP üzerinden kaynak bazlı çalışan, en yaygın web servis yaklaşımı.

Webhook

Bir olay olduğunda karşı sisteme anında HTTP bildirimi gönderen yöntem.

Node.js

JavaScript'i sunucuda çalıştıran ortam; API, gerçek zamanlı uygulama ve entegrasyon servisleri için yaygındır.

.NET

Microsoft'un kurumsal uygulama platformu; masaüstü, web ve servis geliştirmede kullanılır.

GraphQL

İstemcinin ihtiyaç duyduğu veriyi tek sorguda istemesini sağlayan API sorgu dili.

02Karşılaştırma tablosu

03API geliştirme planlarken bilinmesi gerekenler

• Kimlik ve yetki bilgileri güvenli saklanır; erişim en az yetkiyle verilir.
• Hata durumunda yeniden deneme, kuyruk ve bildirim kurgulanır.
• Değişikliklere karşı izleme ve bakım planlanır.

04Efeler için çalışma düzeni

Efeler'in PTT verisindeki 84 yerleşim kaydı 4 farklı posta koduna dağılır. Bu kayıtlardan 1 tanesi organize sanayi veya serbest bölge kaydıdır. Büyükşehirlerde merkez ve şube yapısıyla çalışan işletmeler için API geliştirme tasarımında merkez-şube yetki yapısı ve birleşik raporlama öne çıkar.

Yazılım projelerinde analiz, tasarım ve geliştirme çoğunlukla uzaktan, görüntülü toplantılarla yürür; Efeler'deki işletmelerle ekran paylaşımlı demolar ve ortak bir proje panosu üzerinden çalışılır. Donanım kurulumu, saha keşfi veya kullanıcı eğitimi gereken işlerde yerinde çalışma planlanır.

Aydın genelinde Aydın Yenipazar, Köşk ve Sultanhisar gibi diğer ilçelerdeki işletmelerle de aynı uzaktan çalışma düzeniyle ilerlenir.

05API geliştirme hangi ihtiyaca cevap verir?

Eski bir sistem bırakılamadığında

Ara katman sayesinde eski sistem çalışmaya devam ederken verisi yeni süreçlere açılır.

Dokümantasyon gerektiğinde

Dokümantasyon, API geliştirme projesinde kapsamın başında konuşulan başlıklardandır; analizde kimin kullanacağı ve nasıl çalışacağı netleştirilir.

06Barındırma seçenekleri

• Bulut sunucu (VPS): esnek, kaynak ihtiyacına göre büyütülebilir
• Yönetilen platformlar: altyapı yönetimini sağlayıcıya bırakır
• Şirket içi sunucu: verinin kurum içinde kalması gerektiğinde
• Konteyner tabanlı yayın (Docker): her ortamda aynı kurulum

Uygulamayı bağımlılıklarıyla birlikte konteynere paketleyen araç; her ortamda aynı şekilde çalışmasını sağlar.

07Neden "en yeni" değil "doğru" teknoloji?

Teknoloji seçimi uzun vadeli bakım maliyetini belirler. Yaygın, belgelenmiş ve ekibin bildiği bir teknoloji; en yeni ama az bilinen bir teknolojiden çoğu zaman daha doğru bir tercihtir.

08Ölçeklenebilirlik

Ölçek ihtiyacı tahminle değil ölçümle belirlenir; izleme kurulur, darboğaz görüldüğünde ilgili katman güçlendirilir.

SSSSık sorulan sorular

→İlgili sayfalar

Bu sayfada geçen kavramlar

• REST
• kimlik doğrulama
• dokümantasyon
• CSV
• webhook
• token
• JSON
• OAuth
• yeniden deneme
• SOAP
• Aydın
• Efeler