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.
Webhook
Bir olay olduğunda karşı sisteme anında HTTP bildirimi gönderen yöntem.
02Karşılaştırma tablosu
| Teknoloji | Güçlü yönü | Dikkat edilecek |
|---|---|---|
| GraphQL | esnek veri sorgulama | sorgu maliyeti ve yetki kontrolü dikkat ister |
| Node.js | eşzamanlı çok bağlantıyı verimli yönetir | yoğun hesaplama işlerinde ayrı servis gerekebilir |
| REST API | geniş araç desteği | sürümleme ve hata kodları tutarlı tasarlanmalı |
| OAuth 2.0 / OIDC | güvenli yetkilendirme | token süreleri ve kapsamlar doğru ayarlanmalı |
| Webhook | anlık bildirim | imza doğrulama ve yeniden deneme gerekir |
03API geliştirme planlarken bilinmesi gerekenler
- Değişikliklere karşı izleme ve bakım planlanır.
- Hangi veri, hangi yönde, ne sıklıkla akacak?
- 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ü.
04Gömeç'te API geliştirme
Gömeç, Balıkesir iline bağlı bir ilçedir ve PTT adres verisine göre 13 mahalleden oluşur. 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; Gömeç'teki 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.
Balıkesir genelinde Altıeylül, Havran ve Kepsut gibi diğer ilçelerdeki işletmelerle de aynı uzaktan çalışma düzeniyle ilerlenir.
Mevcut Excel dosyanızı veya ekran görüntülerinizi WhatsApp'tan gönderin; API geliştirme için hangi modüllerle başlanabileceğini konuşalım. Telefon: 0540 003 19 81.
05API geliştirme hangi ihtiyaca cevap verir?
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.
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.
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
Gömeç'te bulunuyorum, yerinde görüşme mümkün mü?
İşin büyük bölümü uzaktan yürür: ilk görüşme telefonla, sonraki toplantılar görüntülü yapılır. Kurulum ya da eğitim gerekiyorsa yerinde çalışma takvime eklenir.
Balıkesir dışındaki işletmelere de hizmet veriyor musunuz?
Evet. Askadar Yazılım, Türkiye'nin 81 ilindeki işletmelerle uzaktan çalışır; gerektiğinde yerinde çalışma ayrıca planlanır.
Bulut mu şirket içi sunucu mu?
Esneklik ve kolay yönetim için bulut; verinin kurum içinde kalması gerektiğinde şirket içi sunucu tercih edilir. Hibrit yapı da mümkündür.
API geliştirme için hangi bilgiler hazırlanmalı?
Mevcut sürecin kısa anlatımı, kullanılan dosya ve program örnekleri, kullanıcı sayısı ve REST gibi beklentiler ilk görüşme için yeterlidir; kapsam analizde netleşir.
Teknolojiyi biz mi seçmeliyiz?
İhtiyacınızı ve tercihlerinizi (barındırma, mevcut ekip, bütçe) paylaşmanız yeterli; seçenekleri artı ve eksileriyle sunar, kararı birlikte veririz.
Açık kaynak teknoloji güvenli mi?
Yaygın ve düzenli güncellenen açık kaynak teknolojiler, doğru yapılandırma ve güncelleme disipliniyle güvenle kullanılır.
Kullanılan teknoloji ileride sorun olur mu?
Yaygın ve düzenli güncellenen teknolojiler seçildiğinde başka bir ekip de projeyi devralabilir; dokümantasyon bu riski ayrıca azaltır.
API geliştirme sonradan genişletilebilir mi?
Evet. Kimlik doğrulama gibi özellikler ilk sürümde olmasa da modüler yapı sayesinde sürüm planıyla eklenebilir.
→İlgili sayfalar
API Geliştirme hakkında diğer konular
- API geliştirme geçiş ve veri aktarımıExcel'den veya eski sistemden geçiş
- API geliştirme güvenlik ve KVKK uyumuYetki, yedek, log ve KVKK
- API geliştirme KOBİ'ler içinKüçük ve orta işletmeler için yol haritası
- API geliştirme bakım ve destekYayın sonrası bakım, güncelleme ve destek
- API geliştirme özellikleri ve modülleriOlması gereken modüller ve özellikler
Gömeç'te ilgili hizmetler
Balıkesir içindeki diğer ilçeler
Bu sayfada geçen kavramlar
- REST
- kimlik doğrulama
- dokümantasyon
- CSV
- webhook
- token
- log
- senkronizasyon
- JSON
- Balıkesir
- Gömeç