01Kullanılabilecek teknolojiler
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.
OAuth 2.0 / OIDC
Parola paylaşmadan yetki vermeyi ve tek oturum açmayı (SSO) sağlayan standartlar.
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ı.
02Karşılaştırma tablosu
| Teknoloji | Güçlü yönü | Dikkat edilecek |
|---|---|---|
| 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ı |
| OAuth 2.0 / OIDC | güvenli yetkilendirme | token süreleri ve kapsamlar doğru ayarlanmalı |
| 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ı |
03Raporlama apı'si planlarken bilinmesi gerekenler
- OpenAPI dokümantasyonu
- webhook imza doğrulaması
- hata kodu standardı.
04Sarıçam için çalışma düzeni
Sarıçam'ın PTT verisindeki 70 yerleşim kaydı 5 farklı posta koduna dağılır. Bu kayıtlardan 1 tanesi organize sanayi veya serbest bölge kaydıdı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.
Sarıçam'da 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. Yazılım projelerinde analiz, tasarım ve geliştirme çoğunlukla uzaktan, görüntülü toplantılarla yürür; Sarıçam'daki 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.
Adana genelinde Tufanbeyli, Karaisalı ve Aladağ 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.
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
Ö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
Sarıçam'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.
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.
Sadece Adana için mi çalışıyorsunuz?
Hayır, Türkiye'nin her ilindeki işletmelerle çalışıyoruz; Akdeniz Bölgesi dahil tüm bölgelerde süreç aynı düzenle yürü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.
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.
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.
→İ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 KOBİ'ler içinKüçük ve orta işletmeler için yol haritası
- Raporlama apı'si geliştirme süreciAnalizden yayına aşamalar
- Raporlama apı'si firmasıFirma seçerken bakılacaklar
Sarıçam'da ilgili hizmetler
Adana içindeki diğer ilçeler
Bu sayfada geçen kavramlar
- filtre
- sayfalama
- önbellek
- SSO
- API anahtarı
- OAuth 2.0
- rate limit
- OpenAPI
- Adana
- Sarıçam