Dış sistemlere veri/servis sunan API ürünü.
01Olmazsa olmaz özellikler
- sürümleme
- kota
- izleme
02İhtiyaca göre eklenen modüller
SSO ve OAuth
Bu modül, iş akışınız gerektiriyorsa kapsamın başında konuşulur; aksi halde sonraki sürüm planına bırakılabilir.
Geliştirici portalı
Geliştirici portalı, ihtiyaç netleştiğinde özel API servisi içine ayrı bir modül olarak eklenebilir; ilk sürümde zorunlu değildir.
Kota ve oran sınırı
Bu modül, iş akışınız gerektiriyorsa kapsamın başında konuşulur; aksi halde sonraki sürüm planına bırakılabilir.
Sürümlü API
Sürümlü API için kimin kullanacağı ve hangi veriye ihtiyaç duyulacağı analizde belirlenir.
03Özel API servisi planlarken bilinmesi gerekenler
- kimlik doğrulama (API anahtarı, OAuth 2.0)
- webhook imza doğrulaması
- OpenAPI dokümantasyonu
04Sık karşılaşılan durumlar
| Durum | Olası neden | Çözüm |
|---|---|---|
| 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 |
| Webhook bildirimleri kayboluyor | Yeniden deneme ve teslim kaydı yok | İmzalı webhook, kuyruk ve teslim logu |
| İş ortakları API'yi yanlış kullanıyor | Dokümantasyon eksik veya güncel değil | OpenAPI şeması, örnek istekler ve sürüm notları |
05Kullanıcı rolleri ve yetkiler
| Rol | Görebilir | Yapabilir |
|---|---|---|
| Yönetici | Tüm birimler | Onay ve yetki |
| Birim sorumlusu | Kendi birimi | Onay, atama, rapor |
| Kullanıcı | Kendi kayıtları | Giriş ve takip |
| Denetçi | Salt okunur raporlar | Dışa aktarım |
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.
Arayüz mobil uyumlu tasarlanır; sahada veya yolda olan kullanıcılar tarayıcıdan aynı ekranlara erişir. Kamera, barkod veya çevrimdışı kullanım gerekiyorsa mobil uygulama değerlendirilir.
07Sektöre göre özellik önerileri
- Platform kuran girişimler: Özel API servisi, platform kuran girişimler için iş akışına göre uyarlanır.
- Yazılım şirketleri: Özel API servisi, yazılım şirketleri için iş akışına göre uyarlanır.
- Veri sağlayıcıları: Özel API servisi, veri sağlayıcıları için iş akışına göre uyarlanır.
- İş ortağı ekosistemi olan firmalar: Özel API servisi, iş ortağı ekosistemi olan firmalar için iş akışına göre uyarlanır.
08Kaynarca için özellik planı
Kaynarca, Sakarya iline bağlı bir ilçedir ve PTT adres verisine göre 45 mahalleden oluşur. Birden fazla ilçede ekibi veya şubesi olan işletmelerde özel API servisi için kullanıcı rolleri, şube bazlı görünürlük ve merkezi raporlar birlikte planlanır.
Kaynarca'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 Sapanca, Adapazarı ve Karapürçek ilçeleri için de özel API servisi talepleri değerlendirilir; toplantılar uzaktan yapılır.
Özel API servisini planlıyorsanız 0540 003 19 81 numarasını arayın veya WhatsApp'tan ihtiyacınızı birkaç cümleyle yazın; teklif formunu da doldurabilirsiniz.
SSSSık sorulan sorular
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.
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.
Ö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.
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.
Sakarya 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.
Kaynarca'dan yazıyorum; toplantılar nasıl yapılıyor?
Toplantılar görüntülü yapılır ve ekran paylaşımıyla ilerler. Cihaz kurulumu, saha incelemesi veya ekip eğitimi gibi yerinde bulunmayı gerektiren adımlar ayrıca planlanır.
Özel API servisi sonradan genişletilebilir mi?
Evet. Kota gibi özellikler ilk sürümde olmasa da modüler yapı sayesinde sürüm planıyla eklenebilir.
Tüm özellikler ilk sürümde mi olmalı?
Hayır. İlk sürüm en çok zaman kaybettiren işi çözmeye odaklanır; diğer özellikler kullanım verisi ve geri bildirimle sürüm planına alınır.
→İlgili sayfalar
Özel API Servisi hakkında diğer konular
- Özel API servisi bakım ve destekYayın sonrası bakım, güncelleme ve destek
- Özel API servisi fiyatlarıMaliyeti belirleyen kalemler ve teklif karşılaştırma
- Özel API servisi entegrasyonlarıBağlanabilecek sistemler
- Özel API servisi güvenlik ve KVKK uyumuYetki, yedek, log ve KVKK
- Özel API servisi yaptırmaKapsam, süreç ve iletişim
Kaynarca'da ilgili hizmetler
Sakarya içindeki diğer ilçeler
Bu sayfada geçen kavramlar
- sürümleme
- kota
- izleme
- SSO
- rate limit
- OpenAPI
- webhook
- SDK
- Sakarya
- Kaynarca