Dış sistemlere veri/servis sunan API ürünü.
01Olmazsa olmaz özellikler
- sürümleme
- kota
- izleme
02İhtiyaca göre eklenen modüller
Sürümlü API
Sürümlü API 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.
SSO ve OAuth
SSO ve OAuth, ihtiyaç netleştiğinde özel API servisi içine ayrı bir modül olarak eklenebilir; ilk sürümde zorunlu değildir.
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.
03Özel API servisi planlarken bilinmesi gerekenler
- oran sınırı ve kota
- kimlik doğrulama (API anahtarı, OAuth 2.0)
- webhook imza doğrulaması
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 |
| İş ortakları API'yi yanlış kullanıyor | Dokümantasyon eksik veya güncel değil | OpenAPI şeması, örnek istekler ve sürüm notları |
| API yoğunlukta yavaşlıyor | Kota ve önbellek yok, sorgular optimize değil | Oran sınırı, önbellek ve sorgu iyileştirme |
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.
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
- İş 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.
- Kurumsal BT ekipleri: Özel API servisi, kurumsal BT ekipleri 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.
08Gölpazarı için özellik planı
Gölpazarı, Bilecik iline bağlı bir ilçedir ve PTT adres verisine göre 69 mahalle ve köy kaydından oluşur.
Gölpazarı'nda 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 Bilecik Merkez, Osmaneli ve Bilecik Yenipazar ilçeleri için de özel API servisi talepleri değerlendirilir; toplantılar uzaktan yapılır.
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.
Ö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.
API'yi kimlerin kullandığını nasıl izleriz?
Her istemciye ayrı anahtar veya OAuth istemcisi verilir; kullanım, hata ve kota tüketimi istemci bazında raporlanır.
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.
Gölpazarı'nda 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.
Bilecik dışındaki işletmelere de hizmet veriyor musunuz?
Hayır, Türkiye'nin her ilindeki işletmelerle çalışıyoruz; Marmara Bölgesi dahil tüm bölgelerde süreç aynı düzenle yürür.
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
Gölpazarı'nda ilgili hizmetler
Bilecik içindeki diğer ilçeler
Bu sayfada geçen kavramlar
- sürümleme
- kota
- izleme
- SSO
- rate limit
- OpenAPI
- SDK
- Bilecik
- Gölpazarı