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

01Kullanılabilecek teknolojiler

GraphQL

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

REST API

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

.NET

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

OAuth 2.0 / OIDC

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

Node.js

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

02Karşılaştırma tablosu

03API geliştirme planlarken bilinmesi gerekenler

• Hangi veri, hangi yönde, ne sıklıkla akacak?
• Lisanslı ürünlerde (Logo, Mikro, Netsis, Nebim, SAP) entegrasyon, ürünün resmî entegrasyon araçları ve lisans koşullarıyla yapılır.
• Bağlantı yöntemi, sistemin sunduğu imkâna göre seçilir: REST/SOAP API, webhook, dosya (CSV/XML), veritabanı görünümü.

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

Maltepe'nin PTT verisindeki 18 yerleşim kaydı 9 farklı posta koduna dağılır. Birden fazla ilçede ekibi veya şubesi olan işletmelerde API geliştirme için kullanıcı rolleri, şube bazlı görünürlük ve merkezi raporlar birlikte planlanır.

Yazılım projelerinde analiz, tasarım ve geliştirme çoğunlukla uzaktan, görüntülü toplantılarla yürür; Maltepe'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.

İstanbul genelinde Gaziosmanpaşa, Kağıthane ve Pendik 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

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
• middleware
• SOAP
• İstanbul
• Maltepe