Sisteminizin verisini güvenli şekilde dış sistemlere açan özel API.
01Olmazsa olmaz özellikler
- REST
- kimlik doğrulama
- dokümantasyon
- sürümleme
02İhtiyaca göre eklenen modüller
İzleme ve uyarı
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.
Ara katman (middleware)
Ara katman (middleware), ihtiyaç netleştiğinde API geliştirme içine ayrı bir modül olarak eklenebilir; ilk sürümde zorunlu değildir.
Zamanlanmış toplu aktarım
Zamanlanmış toplu aktarım, ihtiyaç netleştiğinde API geliştirme içine ayrı bir modül olarak eklenebilir; ilk sürümde zorunlu değildir.
Çift yönlü senkronizasyon
Çift yönlü senkronizasyon için kimin kullanacağı ve hangi veriye ihtiyaç duyulacağı analizde belirlenir.
03API geliştirme planlarken bilinmesi gerekenler
- Hata durumunda yeniden deneme, kuyruk ve bildirim kurgulanır.
- Lisanslı ürünlerde (Logo, Mikro, Netsis, Nebim, SAP) entegrasyon, ürünün resmî entegrasyon araçları ve lisans koşullarıyla yapılır.
- Bağlantı yöntemi, sistemin sunduğu imkâna göre seçilir: REST/SOAP API, webhook, dosya (CSV/XML), veritabanı görünümü.
04Sık karşılaşılan durumlar
| Durum | Olası neden | Çözüm |
|---|---|---|
| Çift kayıt oluşuyor | Eşsiz anahtar yok | Eşleştirme kuralı |
| Veriler iki kez giriliyor | Sistemler bağlı değil | Entegrasyon |
| Entegrasyon sessizce durmuş | İzleme yok | Hata bildirimi ve log |
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
- ERP kullanan firmalar: API geliştirme, ERP kullanan firmalar için iş akışına göre uyarlanır.
- Kurumsal satış ekipleri: API geliştirme, kurumsal satış ekipleri için iş akışına göre uyarlanır.
- Yazılım ekosistemi dağınık firmalar: API geliştirme, yazılım ekosistemi dağınık firmalar için iş akışına göre uyarlanır.
- E-ticaret ve B2B satıcıları: API geliştirme, e-ticaret ve B2B satıcıları için iş akışına göre uyarlanır.
08Toprakkale için özellik planı
Toprakkale'nin PTT verisindeki 16 yerleşim kaydı 3 farklı posta koduna dağılır.
Yazılım projelerinde analiz, tasarım ve geliştirme çoğunlukla uzaktan, görüntülü toplantılarla yürür; Toprakkale'deki işletmelerle ekran paylaşımlı demolar ve ortak bir proje panosu üzerinden çalışılır. Donanım kurulumu, saha keşfi veya kullanıcı eğitimi gereken işlerde yerinde çalışma planlanır.
Aynı ildeki Hasanbeyli, Osmaniye Merkez ve Bahçe ilçeleri için de API geliştirme talepleri değerlendirilir; toplantılar uzaktan yapılır.
Toprakkale bölgesinden API geliştirme 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
API geliştirme sonradan genişletilebilir mi?
Evet. Kimlik doğrulama gibi özellikler ilk sürümde olmasa da modüler yapı sayesinde sürüm planıyla eklenebilir.
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.
Logo veya Mikro entegrasyonu için lisans gerekir mi?
Entegrasyon ürünün resmî araçları ve lisans koşullarıyla yapılır; bazı bağlantı yöntemleri ek modül veya kullanıcı lisansı gerektirebilir. Bunu analizde ürün sağlayıcınızın güncel koşullarıyla birlikte netleştiririz.
Toprakkale'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.
Ö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.
API geliştirme için hangi bilgiler hazırlanmalı?
Mevcut sürecin kısa anlatımı, kullanılan dosya ve program örnekleri, kullanıcı sayısı ve REST gibi beklentiler ilk görüşme için yeterlidir; kapsam analizde netleşir.
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.
→İlgili sayfalar
API Geliştirme hakkında diğer konular
- API geliştirme firmasıFirma seçerken bakılacaklar
- API geliştirme geliştirme süreciAnalizden yayına aşamalar
- API geliştirme güvenlik ve KVKK uyumuYetki, yedek, log ve KVKK
- API geliştirme geçiş ve veri aktarımıExcel'den veya eski sistemden geçiş
- API geliştirme: hazır paket mi özel yazılım mı?Hazır çözüm ile özel geliştirmenin farkı
Toprakkale'de ilgili hizmetler
Osmaniye içindeki diğer ilçeler
Bu sayfada geçen kavramlar
- REST
- kimlik doğrulama
- dokümantasyon
- CSV
- webhook
- token
- OAuth
- senkronizasyon
- yeniden deneme
- Osmaniye
- Toprakkale