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

01Kullanılabilecek teknolojiler

OAuth 2.0 / OIDC

Parola paylaşmadan yetki vermeyi ve tek oturum açmayı (SSO) sağlayan standartlar.

.NET

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

Node.js

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

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.

02Karşılaştırma tablosu

03API geliştirme planlarken bilinmesi gerekenler

• Hata durumunda yeniden deneme, kuyruk ve bildirim kurgulanır.
• Lisanslı ürünlerde (Logo, Mikro, Netsis, Nebim, SAP) entegrasyon, ürünün resmî entegrasyon araçları ve lisans koşullarıyla yapılır.
• Kimlik ve yetki bilgileri güvenli saklanır; erişim en az yetkiyle verilir.

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

Yomra, Trabzon iline bağlı bir ilçedir ve PTT adres verisine göre 25 mahalleden oluşur. 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; Yomra'daki 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.

Trabzon genelinde Tonya, Vakfıkebir ve Beşikdüzü gibi diğer ilçelerdeki işletmelerle de aynı uzaktan çalışma düzeniyle ilerlenir.

05API geliştirme hangi ihtiyaca cevap verir?

Yeni bir yazılım devreye alınırken

Mevcut sistemler değiştirilmeden yeni yazılımla bağlantı kurulur; geçiş kademeli yapı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

API geliştirme büyüdükçe veritabanı indeksleri, önbellek ve arka plan kuyrukları devreye girer; mimari bu adımlara baştan izin verecek şekilde kurulur.

SSSSık sorulan sorular

→İlgili sayfalar

Bu sayfada geçen kavramlar

• REST
• kimlik doğrulama
• dokümantasyon
• CSV
• webhook
• token
• kuyruk
• SOAP
• OAuth
• Trabzon
• Yomra