01Kullanılabilecek teknolojiler
GraphQL
İstemcinin ihtiyaç duyduğu veriyi tek sorguda istemesini sağlayan API sorgu dili.
REST API
HTTP üzerinden kaynak bazlı çalışan, en yaygın web servis yaklaşımı.
Webhook
Bir olay olduğunda karşı sisteme anında HTTP bildirimi gönderen yöntem.
OAuth 2.0 / OIDC
Parola paylaşmadan yetki vermeyi ve tek oturum açmayı (SSO) sağlayan standartlar.
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 |
|---|---|---|
| GraphQL | esnek veri sorgulama | sorgu maliyeti ve yetki kontrolü dikkat ister |
| REST API | geniş araç desteği | sürümleme ve hata kodları tutarlı tasarlanmalı |
| Webhook | anlık bildirim | imza doğrulama ve yeniden deneme gerekir |
| OAuth 2.0 / OIDC | güvenli yetkilendirme | token süreleri ve kapsamlar doğru ayarlanmalı |
| 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
- oran sınırı ve kota
04Karpuzlu için çalışma düzeni
Karpuzlu'nun PTT verisindeki 23 yerleşim kaydı 1 farklı posta koduna dağılı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.
Mesafe yazılım işinin önünde engel değildir: Karpuzlu'daki 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 Söke, Nazilli ve Buharkent gibi diğer ilçelerdeki işletmelerle de aynı uzaktan çalışma düzeniyle ilerlenir.
Karpuzlu 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
DNS, CDN, önbellek, SSL ve güvenlik katmanı sunan altyapı hizmeti.
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
Sadece Aydın için mi çalışıyorsunuz?
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.
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.
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.
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.
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.
Karpuzlu'da yüz yüze görüşebilir miyiz?
İş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.
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.
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 geçiş ve veri aktarımıExcel'den veya eski sistemden geçiş
- Raporlama apı'si güvenlik ve KVKK uyumuYetki, yedek, log ve KVKK
- Raporlama apı'si: hazır paket mi özel yazılım mı?Hazır çözüm ile özel geliştirmenin farkı
- Raporlama apı'si özellikleri ve modülleriOlması gereken modüller ve özellikler
- Raporlama apı'si entegrasyonlarıBağlanabilecek sistemler
Karpuzlu'da ilgili hizmetler
Aydın içindeki diğer ilçeler
Bu sayfada geçen kavramlar
- filtre
- sayfalama
- önbellek
- SSO
- API anahtarı
- OAuth 2.0
- SDK
- rate limit
- Swagger
- geliştirici portalı
- Aydın
- Karpuzlu