01Kullanılabilecek teknolojiler
Node.js
JavaScript'i sunucuda çalıştıran ortam; API, gerçek zamanlı uygulama ve entegrasyon servisleri için yaygındır.
GraphQL
İstemcinin ihtiyaç duyduğu veriyi tek sorguda istemesini sağlayan API sorgu dili.
Webhook
Bir olay olduğunda karşı sisteme anında HTTP bildirimi gönderen yöntem.
PostgreSQL
Açık kaynaklı, güçlü ilişkisel veritabanı; karmaşık sorgular, JSON verisi ve büyük tablolar için uygundur.
REST API
HTTP üzerinden kaynak bazlı çalışan, en yaygın web servis yaklaşımı.
02Karşılaştırma tablosu
| Teknoloji | Güçlü yönü | Dikkat edilecek |
|---|---|---|
| Node.js | eşzamanlı çok bağlantıyı verimli yönetir | yoğun hesaplama işlerinde ayrı servis gerekebilir |
| GraphQL | esnek veri sorgulama | sorgu maliyeti ve yetki kontrolü dikkat ister |
| Webhook | anlık bildirim | imza doğrulama ve yeniden deneme gerekir |
| PostgreSQL | veri bütünlüğü ve gelişmiş sorgular | indeks ve bakım (vacuum) planı yapılmalı |
| REST API | geniş araç desteği | sürümleme ve hata kodları tutarlı tasarlanmalı |
03Raporlama apı'si planlarken bilinmesi gerekenler
- hata kodu standardı.
- sürümleme stratejisi
- OpenAPI dokümantasyonu
04Kuşadası için çalışma düzeni
Kuşadası, Aydın iline bağlı bir ilçedir ve PTT adres verisine göre 23 mahalleden oluşur.
Kuşadası'nda bulunan bir işletmeyle çalışırken toplantılar görüntülü yapılır, her aşama test ortamında paylaşılır ve geri bildirimler ortak panoda toplanır; yerinde bulunmak gereken kurulum ve eğitim adımları ayrıca planlanır.
Aydın genelinde Didim, Efeler ve Nazilli 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; raporlama apı'si için hangi modüllerle başlanabileceğini konuşalım. Telefon: 0540 003 19 81.
05Raporlama apı'si hangi ihtiyaca cevap verir?
Oturum açma her üründe ayrı yönetildiğinde
Merkezi kimlik doğrulama ve SSO ile kullanıcı yönetimi sadeleşir.
Olaylar anlık bildirilmesi gerektiğinde
Webhook altyapısı imza doğrulama ve yeniden deneme ile kurulur.
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
REST mi GraphQL mi?
Kaynak bazlı, önbelleğe uygun ve geniş araç desteği gereken çoğu iş API'sinde REST yeterlidir. İstemcilerin çok farklı veri kombinasyonları istediği ürünlerde GraphQL değerlendirilir.
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.
Raporlama apı'si sonradan genişletilebilir mi?
Evet. Sayfalama gibi özellikler ilk sürümde olmasa da modüler yapı sayesinde sürüm planıyla eklenebilir.
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.
Kuşadası'nda yüz yüze görüşebilir miyiz?
Analiz, tasarım ve geliştirme çoğunlukla uzaktan, görüntülü toplantılarla yürür; donanım kurulumu, saha keşfi veya kullanıcı eğitimi gereken işlerde yerinde çalışma planlanır.
Aydın dışındaki işletmelere de hizmet veriyor musunuz?
Hayır, Türkiye'nin her ilindeki işletmelerle çalışıyoruz; Ege Bölgesi dahil tüm bölgelerde süreç aynı düzenle yürü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.
Raporlama apı'si için hangi bilgiler hazırlanmalı?
Mevcut sürecin kısa anlatımı, kullanılan dosya ve program örnekleri, kullanıcı sayısı ve filtre gibi beklentiler ilk görüşme için yeterlidir; kapsam analizde netleşir.
→İlgili sayfalar
Raporlama API'si hakkında diğer konular
- Raporlama apı'si: hazır paket mi özel yazılım mı?Hazır çözüm ile özel geliştirmenin farkı
- Raporlama apı'si güvenlik ve KVKK uyumuYetki, yedek, log ve KVKK
- Raporlama apı'si entegrasyonlarıBağlanabilecek sistemler
- Raporlama apı'si özellikleri ve modülleriOlması gereken modüller ve özellikler
- Raporlama apı'si KOBİ'ler içinKüçük ve orta işletmeler için yol haritası
Kuşadası'nda ilgili hizmetler
Aydın içindeki diğer ilçeler
Bu sayfada geçen kavramlar
- filtre
- sayfalama
- önbellek
- SSO
- API anahtarı
- OAuth 2.0
- rate limit
- OpenAPI
- SDK
- Aydın
- Kuşadası