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
İmzalı webhook, ihtiyaç netleştiğinde özel API servisi içine ayrı bir modül olarak eklenebilir; ilk sürümde zorunlu değildir.
Sürümlü API
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ı
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.
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
- webhook imza doğrulaması
- oran sınırı ve kota
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
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
- Platform kuran girişimler: Özel API servisi, platform kuran girişimler 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.
- Yazılım şirketleri: Özel API servisi, yazılım şirketleri 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.
08Halfeti için özellik planı
Halfeti, Şanlıurfa iline bağlı bir ilçedir ve PTT adres verisine göre 49 mahalleden oluşur. Büyükşehirlerde merkez ve şube yapısıyla çalışan işletmeler için özel API servisi tasarımında merkez-şube yetki yapısı ve birleşik raporlama öne çıkar.
Mesafe yazılım işinin önünde engel değildir: Halfeti'deki 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.
Şanlıurfa genelinde Haliliye, Viranşehir ve Birecik 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; özel API servisi için hangi modüllerle başlanabileceğini konuşalım. Telefon: 0540 003 19 81.
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.
Ö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.
Ö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.
Ö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.
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.
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.
Halfeti'den 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.
→İlgili sayfalar
Özel API Servisi hakkında diğer konular
- Özel API servisi KOBİ'ler içinKüçük ve orta işletmeler için yol haritası
- Özel API servisi geçiş ve veri aktarımıExcel'den veya eski sistemden geçiş
- Özel API servisi güvenlik ve KVKK uyumuYetki, yedek, log ve KVKK
- Özel API servisi teknolojileriTeknoloji seçimi ve mimari
- Özel API servisi bakım ve destekYayın sonrası bakım, güncelleme ve destek
Halfeti'de ilgili hizmetler
Şanlıurfa içindeki diğer ilçeler
Bu sayfada geçen kavramlar
- sürümleme
- kota
- izleme
- SSO
- rate limit
- OpenAPI
- SDK
- webhook
- Şanlıurfa
- Halfeti