01Kullanılabilecek teknolojiler
Webhook
Bir olay olduğunda karşı sisteme anında HTTP bildirimi gönderen yöntem.
REST API
HTTP üzerinden kaynak bazlı çalışan, en yaygın web servis yaklaşımı.
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.
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 |
|---|---|---|
| Webhook | anlık bildirim | imza doğrulama ve yeniden deneme gerekir |
| REST API | geniş araç desteği | sürümleme ve hata kodları tutarlı tasarlanmalı |
| 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 |
| 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
- oran sınırı ve kota
- hata kodu standardı.
04İscehisar için çalışma düzeni
PTT kayıtlarında İscehisar ilçesine bağlı 39 yerleşim bulunur: 13 mahalle ile 26 köy ve köy yerleşimi. Bu kayıtlardan 1 tanesi organize sanayi veya serbest bölge kaydıdır. İscehisar'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.
Mesafe yazılım işinin önünde engel değildir: İscehisar'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.
Aynı ildeki İhsaniye, Başmakçı ve Hocalar ilçeleri için de raporlama apı'si talepleri değerlendirilir; toplantılar uzaktan yapılır.
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.
Filtre gerektiğinde
Filtre, raporlama apı'si projesinde kapsamın başında konuşulan başlıklardandır; analizde kimin kullanacağı ve nasıl çalışacağı netleştirilir.
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?
Doğru teknoloji; ihtiyacı karşılayan, yeni bir geliştiricinin kolayca devralabileceği ve güncellemeleri düzenli çıkan teknolojidir.
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
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.
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.
İscehisar'dan yazıyorum; toplantılar nasıl yapılıyor?
İş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.
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.
Afyonkarahisar 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.
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.
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.
→İlgili sayfalar
Raporlama API'si hakkında diğer konular
İscehisar'da ilgili hizmetler
Afyonkarahisar içindeki diğer ilçeler
Bu sayfada geçen kavramlar
- filtre
- sayfalama
- önbellek
- SSO
- API anahtarı
- OAuth 2.0
- webhook
- Afyonkarahisar
- İscehisar