Dış sistemlere veri/servis sunan API ürünü.
01Olmazsa olmaz özellikler
- sürümleme
- kota
- izleme
02İhtiyaca göre eklenen modüller
İmzalı webhook
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.
Geliştirici portalı
Geliştirici portalı için kimin kullanacağı ve hangi veriye ihtiyaç duyulacağı analizde belirlenir.
OpenAPI dokümantasyonu
OpenAPI dokümantasyonu, ihtiyaç netleştiğinde özel API servisi içine ayrı bir modül olarak eklenebilir; ilk sürümde zorunlu değildir.
03Özel API servisi planlarken bilinmesi gerekenler
- sürümleme stratejisi
- OpenAPI dokümantasyonu
- hata kodu standardı.
04Sık karşılaşılan durumlar
| Durum | Olası neden | Çözüm |
|---|---|---|
| Webhook bildirimleri kayboluyor | Yeniden deneme ve teslim kaydı yok | İmzalı webhook, kuyruk ve teslim logu |
| 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 |
| İş 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
Rapor ihtiyacı, kararların hangi rakamlara bakılarak verildiği sorusuyla belirlenir; her rapor bir karara hizmet etmelidir.
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
- İş ortağı ekosistemi olan firmalar: Özel API servisi, iş ortağı ekosistemi olan firmalar 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.
- Platform kuran girişimler: Özel API servisi, platform kuran girişimler için iş akışına göre uyarlanır.
- Kurumsal BT ekipleri: Özel API servisi, kurumsal BT ekipleri için iş akışına göre uyarlanır.
08Kangal için özellik planı
Kangal, Sivas iline bağlı bir ilçedir ve PTT adres verisine göre 172 mahalle ve köy kaydından oluşur.
Kangal'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 Gemerek, Şarkışla ve Hafik ilçeleri için de özel API servisi talepleri değerlendirilir; toplantılar uzaktan yapılır.
Kangal bölgesinden özel API servisi için ilk görüşmeyi telefonla yapabiliriz: 0540 003 19 81. İsterseniz kısa bir not bırakın, biz arayalım.
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.
Sivas dışındaki işletmelere de hizmet veriyor musunuz?
Hayır, Türkiye'nin her ilindeki işletmelerle çalışıyoruz; İç Anadolu Bölgesi dahil tüm bölgelerde süreç aynı düzenle yürür.
Ö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.
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.
Ö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.
Kangal'da yüz yüze görüşebilir miyiz?
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 için hangi bilgiler hazırlanmalı?
Mevcut sürecin kısa anlatımı, kullanılan dosya ve program örnekleri, kullanıcı sayısı ve sürümleme gibi beklentiler ilk görüşme için yeterlidir; kapsam analizde netleşir.
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.
→İlgili sayfalar
Özel API Servisi hakkında diğer konular
- Özel API servisi: hazır paket mi özel yazılım mı?Hazır çözüm ile özel geliştirmenin farkı
- Özel API servisi fiyatlarıMaliyeti belirleyen kalemler ve teklif karşılaştırma
- Özel API servisi geliştirme süreciAnalizden yayına aşamalar
- Özel API servisi firmasıFirma seçerken bakılacaklar
- Özel API servisi teknolojileriTeknoloji seçimi ve mimari
Kangal'da ilgili hizmetler
Sivas içindeki diğer ilçeler
Bu sayfada geçen kavramlar
- sürümleme
- kota
- izleme
- SSO
- rate limit
- OpenAPI
- Swagger
- geliştirici portalı
- Sivas
- Kangal