Raporlama API'si Özellikleri ve Modülleri

Raporların dış sistemlere servis olarak sunulması.

01Olmazsa olmaz özellikler

filtre
sayfalama
önbellek

02İhtiyaca göre eklenen modüller

SSO ve OAuth

SSO ve OAuth için kimin kullanacağı ve hangi veriye ihtiyaç duyulacağı analizde belirlenir.

OpenAPI dokümantasyonu

OpenAPI dokümantasyonu için kimin kullanacağı ve hangi veriye ihtiyaç duyulacağı analizde belirlenir.

İmzalı webhook

İmzalı webhook için kimin kullanacağı ve hangi veriye ihtiyaç duyulacağı analizde belirlenir.

Geliştirici portalı

Geliştirici portalı, ihtiyaç netleştiğinde raporlama apı'si içine ayrı bir modül olarak eklenebilir; ilk sürümde zorunlu değildir.

03Raporlama apı'si planlarken bilinmesi gerekenler

webhook imza doğrulaması
oran sınırı ve kota
hata kodu standardı.

04Sık karşılaşılan durumlar

Durum	Olası neden	Çözüm
API yoğunlukta yavaşlıyor	Kota ve önbellek yok, sorgular optimize değil	Oran sınırı, önbellek ve sorgu iyileştirme
İş ortakları API'yi yanlış kullanıyor	Dokümantasyon eksik veya güncel değil	OpenAPI şeması, örnek istekler ve sürüm notları
Eski sürümü kullananlar bozuluyor	Sürümleme ve geçiş takvimi yok	Sürümlü uç noktalar ve duyurulu kullanım dışı bırakma

05Kullanıcı rolleri ve yetkiler

Örnek rol yapısıdır; gerçek roller analizde işletmeye göre belirlenir.
Rol	Görebilir	Yapabilir
Yönetici	Tüm kayıtlar ve raporlar	Kullanıcı ve ayar yönetimi
Çalışan	Kendi işleri ve atananlar	Kayıt girişi ve güncelleme
Müşteri / bayi	Kendi kayıtları	Talep ve sipariş

06Raporlar ve mobil kullanım

Raporlar ilk günden çok sayıda olmamalı; yöneticinin her hafta baktığı birkaç temel rapor kurulur, kullanıldıkça zenginleştirilir.

Telefon ve tablette kullanılacak ekranlar sadeleştirilir; en sık yapılan işlem tek dokunuşla erişilebilir olur.

07Sektöre göre özellik önerileri

Veri sağlayıcıları: Raporlama apı'si, veri sağlayıcıları için iş akışına göre uyarlanır.
Platform kuran girişimler: Raporlama apı'si, platform kuran girişimler için iş akışına göre uyarlanır.
İş ortağı ekosistemi olan firmalar: Raporlama apı'si, iş ortağı ekosistemi olan firmalar için iş akışına göre uyarlanır.
Kurumsal BT ekipleri: Raporlama apı'si, kurumsal BT ekipleri için iş akışına göre uyarlanır.

08Samsat için özellik planı

Samsat'ın PTT verisindeki 40 yerleşim kaydı 2 farklı posta koduna dağılır.

Samsat'ta 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 Besni, Tut ve Adıyaman Merkez ilçeleri için de raporlama apı'si talepleri değerlendirilir; toplantılar uzaktan yapılır.

Samsat 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.

Hemen ara WhatsApp Teklif formu

SSSSık sorulan sorular

Hangi özellik ilk sürümde olmalı?

Her gün kullanılacak ve en çok zaman kazandıracak özellikler ilk sürümde olmalıdır; diğerleri kullanım verisine göre eklenir.

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.

Samsat'ta bulunuyorum, yerinde görüşme mümkün mü?

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.

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.

Özellik listesini nasıl hazırlamalıyım?

Bugün nasıl çalıştığınızı, en çok zaman alan işi ve olmazsa iş yapılamayacak adımları yazmanız yeterli; teknik listeyi analizde birlikte çıkarırız.

Kullanıcı rolleri nasıl belirlenir?

Kimin neyi göreceği, kimin neyi onaylayacağı mevcut iş akışından çıkarılır ve bir yetki matrisiyle belgelenir.

Sadece Adıyaman için mi çalışıyorsunuz?

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

Samsat'ta ilgili hizmetler

Adıyaman içindeki diğer ilçeler

Genel sayfalar

Bu sayfada geçen kavramlar

filtre
sayfalama
önbellek
SSO
API anahtarı
OAuth 2.0
Swagger
geliştirici portalı
Adıyaman
Samsat

Raporlama apı'si: olması gereken özellikler ve modüller (Samsat)