01Kullanılabilecek teknolojiler
REST API
HTTP üzerinden kaynak bazlı çalışan, en yaygın web servis yaklaşımı.
PostgreSQL
Açık kaynaklı, güçlü ilişkisel veritabanı; karmaşık sorgular, JSON verisi ve büyük tablolar için uygundur.
GraphQL
İstemcinin ihtiyaç duyduğu veriyi tek sorguda istemesini sağlayan API sorgu dili.
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
| Teknoloji | Güçlü yönü | Dikkat edilecek |
|---|---|---|
| REST API | geniş araç desteği | sürümleme ve hata kodları tutarlı tasarlanmalı |
| PostgreSQL | veri bütünlüğü ve gelişmiş sorgular | indeks ve bakım (vacuum) planı yapılmalı |
| GraphQL | esnek veri sorgulama | sorgu maliyeti ve yetki kontrolü dikkat ister |
| 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 |
03Raporlama apı'si planlarken bilinmesi gerekenler
- OpenAPI dokümantasyonu
- kimlik doğrulama (API anahtarı, OAuth 2.0)
- oran sınırı ve kota
04Kayapınar için çalışma düzeni
Kayapınar'ın PTT verisindeki 34 yerleşim kaydı 1 farklı posta koduna dağılır. Büyükşehirlerde merkez ve şube yapısıyla çalışan işletmeler için raporlama apı'si tasarımında merkez-şube yetki yapısı ve birleşik raporlama öne çıkar.
Kayapınar'da 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.
Aynı ildeki Kulp, Bismil ve Hani ilçeleri için de raporlama apı'si talepleri değerlendirilir; toplantılar uzaktan yapılır.
Kayapınar bölgesinden raporlama apı'si için ilk görüşmeyi telefonla yapabiliriz: 0540 003 19 81. İsterseniz kısa bir not bırakın, biz arayalım.
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?
Doğru teknoloji; ihtiyacı karşılayan, yeni bir geliştiricinin kolayca devralabileceği ve güncellemeleri düzenli çıkan teknolojidir.
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
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.
API'yi kimlerin kullandığını nasıl izleriz?
Her istemciye ayrı anahtar veya OAuth istemcisi verilir; kullanım, hata ve kota tüketimi istemci bazında raporlanı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.
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.
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.
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.
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.
Diyarbakır 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.
→İlgili sayfalar
Raporlama API'si hakkında diğer konular
- Raporlama apı'si geçiş ve veri aktarımıExcel'den veya eski sistemden geçiş
- Raporlama apı'si KOBİ'ler içinKüçük ve orta işletmeler için yol haritası
- Raporlama apı'si bakım ve destekYayın sonrası bakım, güncelleme ve destek
- Raporlama apı'si özellikleri ve modülleriOlması gereken modüller ve özellikler
- Raporlama apı'si güvenlik ve KVKK uyumuYetki, yedek, log ve KVKK
Kayapınar'da ilgili hizmetler
Diyarbakır içindeki diğer ilçeler
Bu sayfada geçen kavramlar
- filtre
- sayfalama
- önbellek
- SSO
- API anahtarı
- OAuth 2.0
- SDK
- Swagger
- webhook
- Diyarbakır
- Kayapınar