API geliştirme: olması gereken özellikler ve modüller (Akçakale)

01Olmazsa olmaz özellikler

• REST
• kimlik doğrulama
• dokümantasyon
• sürümleme

02İhtiyaca göre eklenen modüller

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.

Çift yönlü senkronizasyon

Çift yönlü senkronizasyon, ihtiyaç netleştiğinde API geliştirme içine ayrı bir modül olarak eklenebilir; ilk sürümde zorunlu değildir.

Anlık (olay tabanlı) aktarım

Anlık (olay tabanlı) aktarım için kimin kullanacağı ve hangi veriye ihtiyaç duyulacağı analizde belirlenir.

Zamanlanmış toplu aktarım

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.

03API geliştirme planlarken bilinmesi gerekenler

• 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ü.
• Hata durumunda yeniden deneme, kuyruk ve bildirim kurgulanır.
• Değişikliklere karşı izleme ve bakım planlanır.

04Kullanıcı rolleri ve yetkiler

05Raporlar 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.

06Sektöre göre özellik önerileri

• ERP kullanan firmalar: API geliştirme, ERP kullanan 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.
• Çok şubeli işletmeler: API geliştirme, çok şubeli işletmeler 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.

07Akçakale için özellik planı

Akçakale, Şanlıurfa iline bağlı bir ilçedir ve PTT adres verisine göre 121 mahalleden oluşur. Büyükşehirlerde merkez ve şube yapısıyla çalışan işletmeler için API geliştirme tasarımında merkez-şube yetki yapısı ve birleşik raporlama öne çıkar.

Yazılım projelerinde analiz, tasarım ve geliştirme çoğunlukla uzaktan, görüntülü toplantılarla yürür; Akçakale'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 Karaköprü, Eyyübiye ve Bozova ilçeleri için de API geliştirme talepleri değerlendirilir; toplantılar uzaktan yapılır.

SSSSık sorulan sorular

→İlgili sayfalar

Bu sayfada geçen kavramlar

• REST
• kimlik doğrulama
• dokümantasyon
• CSV
• webhook
• token
• middleware
• SOAP
• yeniden deneme
• Şanlıurfa
• Akçakale