Dış sistemlere veri/servis sunan API ürünü.
01Olmazsa olmaz özellikler
- sürümleme
- kota
- izleme
02İhtiyaca göre eklenen modüller
Geliştirici portalı
Geliştirici portalı için kimin kullanacağı ve hangi veriye ihtiyaç duyulacağı analizde belirlenir.
İ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.
Kota ve oran sınırı
Kota ve oran sınırı için kimin kullanacağı ve hangi veriye ihtiyaç duyulacağı analizde belirlenir.
03Özel API servisi planlarken bilinmesi gerekenler
- OpenAPI dokümantasyonu
- webhook imza doğrulaması
- sürümleme stratejisi
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ı |
| Webhook bildirimleri kayboluyor | Yeniden deneme ve teslim kaydı yok | İmzalı webhook, kuyruk ve teslim logu |
05Kullanıcı rolleri ve yetkiler
| 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
- Yazılım şirketleri: Özel API servisi, yazılım şirketleri 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.
- Platform kuran girişimler: Özel API servisi, platform kuran girişimler 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.
08Çüngüş için özellik planı
Çüngüş, Diyarbakır iline bağlı bir ilçedir ve PTT adres verisine göre 40 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.
Mesafe yazılım işinin önünde engel değildir: Çüngüş'teki 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.
Diyarbakır genelinde Sur, Ergani ve Hani 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
Ö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.
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.
Çüngüş'te bulunuyorum, yerinde görüşme mümkün mü?
İş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.
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.
Ö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.
Ö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.
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.
→İlgili sayfalar
Özel API Servisi hakkında diğer konular
- Özel API servisi entegrasyonlarıBağlanabilecek sistemler
- Özel API servisi firmasıFirma seçerken bakılacaklar
- Özel API servisi: hazır paket mi özel yazılım mı?Hazır çözüm ile özel geliştirmenin farkı
- Özel API servisi teknolojileriTeknoloji seçimi ve mimari
- Özel API servisi geliştirme süreciAnalizden yayına aşamalar
Çüngüş'te ilgili hizmetler
Diyarbakır içindeki diğer ilçeler
Bu sayfada geçen kavramlar
- sürümleme
- kota
- izleme
- SSO
- rate limit
- OpenAPI
- OAuth 2.0
- Swagger
- API anahtarı
- Diyarbakır
- Çüngüş