01Kullanılabilecek teknolojiler
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.
Webhook
Bir olay olduğunda karşı sisteme anında HTTP bildirimi gönderen yöntem.
GraphQL
İstemcinin ihtiyaç duyduğu veriyi tek sorguda istemesini sağlayan API sorgu dili.
PostgreSQL
Açık kaynaklı, güçlü ilişkisel veritabanı; karmaşık sorgular, JSON verisi ve büyük tablolar için uygundur.
02Karşılaştırma tablosu
| Teknoloji | Güçlü yönü | Dikkat edilecek |
|---|---|---|
| OAuth 2.0 / OIDC | güvenli yetkilendirme | token süreleri ve kapsamlar doğru ayarlanmalı |
| Node.js | eşzamanlı çok bağlantıyı verimli yönetir | yoğun hesaplama işlerinde ayrı servis gerekebilir |
| Webhook | anlık bildirim | imza doğrulama ve yeniden deneme gerekir |
| GraphQL | esnek veri sorgulama | sorgu maliyeti ve yetki kontrolü dikkat ister |
| PostgreSQL | veri bütünlüğü ve gelişmiş sorgular | indeks ve bakım (vacuum) planı yapılmalı |
03Raporlama apı'si planlarken bilinmesi gerekenler
- webhook imza doğrulaması
- OpenAPI dokümantasyonu
- hata kodu standardı.
04Efeler için çalışma düzeni
Efeler, Aydın iline bağlı bir ilçedir ve PTT adres verisine göre 84 mahalleden oluşur. Bu kayıtlardan 1 tanesi organize sanayi veya serbest bölge kaydıdır. Birden fazla ilçede ekibi veya şubesi olan işletmelerde raporlama apı'si için kullanıcı rolleri, şube bazlı görünürlük ve merkezi raporlar birlikte planlanır.
Efeler'de PTT verisine göre 1 OSB/SB kaydı bulunur; üretim ve tedarik zinciriyle çalışan işletmelerde raporlama apı'si için B2B süreçler ve mevcut programlarla entegrasyon ayrıca konuşulur.
Mesafe yazılım işinin önünde engel değildir: Efeler'deki ekiplerle görüntülü görüşme, ekran paylaşımı ve test ortamı bağlantısıyla çalışılır; cihaz kurulumu veya saha keşfi gerekirse yerinde ziyaret planlanır.
Aydın genelinde Germencik, Karpuzlu ve Karacasu gibi diğer ilçelerdeki işletmelerle de aynı uzaktan çalışma düzeniyle ilerlenir.
Raporlama apı'sini planlıyorsanız 0540 003 19 81 numarasını arayın veya WhatsApp'tan ihtiyacınızı birkaç cümleyle yazın; teklif formunu da doldurabilirsiniz.
05Barı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.
06Neden "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.
07Ölçeklenebilirlik
Raporlama apı'si 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
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.
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.
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.
Efeler'de 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.
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.
Sadece Aydın için mi çalışıyorsunuz?
Askadar Yazılım 81 ilde uzaktan çalışır; Aydın de bunlardan biridir. Yerinde iş gerektiğinde ziyaret planlanır.
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.
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.
→İlgili sayfalar
Raporlama API'si hakkında diğer konular
- Raporlama apı'si güvenlik ve KVKK uyumuYetki, yedek, log ve KVKK
- Raporlama apı'si firmasıFirma seçerken bakılacaklar
- Raporlama apı'si geçiş ve veri aktarımıExcel'den veya eski sistemden geçiş
- Raporlama apı'si bakım ve destekYayın sonrası bakım, güncelleme ve destek
- Raporlama apı'si geliştirme süreciAnalizden yayına aşamalar
Efeler'de ilgili hizmetler
Aydın içindeki diğer ilçeler
Bu sayfada geçen kavramlar
- filtre
- sayfalama
- önbellek
- SSO
- API anahtarı
- OAuth 2.0
- geliştirici portalı
- webhook
- SDK
- rate limit
- Aydın
- Efeler