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

01Kullanılabilecek teknolojiler

GraphQL

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

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ı.

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.

02Karşılaştırma tablosu

03API geliştirme planlarken bilinmesi gerekenler

• 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ü.
• Hangi veri, hangi yönde, ne sıklıkla akacak?

04Geyve'de API geliştirme

Geyve, Sakarya iline bağlı bir ilçedir ve PTT adres verisine göre 73 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; Geyve'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.

Aynı ildeki Erenler, Karasu ve Kaynarca ilçeleri için de API geliştirme talepleri değerlendirilir; toplantılar uzaktan yapılır.

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.

Sistemler birbirinden habersiz çalıştığında

Stok, cari, sipariş ve fatura gibi kayıtlar ortak kurallarla eşitlenir; herkes aynı veriyi görür.

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?

Doğru teknoloji; ihtiyacı karşılayan, yeni bir geliştiricinin kolayca devralabileceği ve güncellemeleri düzenli çıkan teknolojidir.

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
• yeniden deneme
• OAuth
• senkronizasyon
• Sakarya
• Geyve