Sur'da API geliştirme yaptırmak

01API geliştirme nedir, kimler için uygun?

API geliştirme projelerinde ihtiyaca göre şu özellikler bir araya getirilir:

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

İhtiyaca göre API entegrasyonu, ERP entegrasyonu ve CRM entegrasyonu da aynı yol haritasına eklenebilir.

02Hangi durumlarda API geliştirme yaptırılır?

Yeni bir yazılım devreye alınırken

Mevcut sistemler değiştirilmeden yeni yazılımla bağlantı kurulur; geçiş kademeli yapılır.

Dokümantasyon gerektiğinde

Dokümantasyon, API geliştirme projesinde kapsamın başında konuşulan başlıklardandır; analizde kimin kullanacağı ve nasıl çalışacağı netleştirilir.

Eski bir sistem bırakılamadığında

Ara katman sayesinde eski sistem çalışmaya devam ederken verisi yeni süreçlere açılır.

03API geliştirme planlarken bilinmesi gerekenler

• Lisanslı ürünlerde (Logo, Mikro, Netsis, Nebim, SAP) entegrasyon, ürünün resmî entegrasyon araçları ve lisans koşullarıyla yapılır.
• Değişikliklere karşı izleme ve bakım planlanır.
• Hangi veri, hangi yönde, ne sıklıkla akacak?

04Sur için uzaktan ve yerinde çalışma

Sur, Diyarbakır iline bağlı bir ilçedir ve PTT adres verisine göre 100 mahalleden oluşur. Birden fazla ilçede ekibi veya şubesi olan işletmelerde API geliştirme 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: Sur'daki 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 Silvan, Hani ve Hazro gibi diğer ilçelerdeki işletmelerle de aynı uzaktan çalışma düzeniyle ilerlenir.

05Proje nasıl ilerler?

1. İlk görüşme: İlk temas telefonla ya da WhatsApp'tan olur; işin kapsamını anlamak için birkaç temel soru sorarız.
2. Analiz: Ekranlar, raporlar ve entegrasyonlar için gerçek örnekler üzerinden ihtiyaç listesi çıkarılır.
3. Kapsam ve yazılı teklif: Modüller, aşamalar ve teslim kriterleri yazılı bir kapsamla belirlenir; teklif bu kapsama göre verilir.
4. Tasarım ve prototip: Temel ekranlar çizilir; kullanıcıların geri bildirimiyle akış sadeleştirilir.
5. Geliştirme ve test: Kod sürüm kontrolüyle yönetilir, kritik akışlar otomatik testlerle korunur.
6. Yayın, veri aktarımı ve eğitim: Veri aktarımı doğrulandıktan sonra yayına geçilir; ekip için kısa kullanım kılavuzu hazırlanır.
7. Bakım ve destek: Yeni ihtiyaçlar sürüm planına alınır; sistem kullanıldıkça geliştirilir.

06Rakamlarla örnek bir senaryo

07Ekip ve çalışma biçimimiz

Tasarım, geliştirme, test ve yayın adımları aynı ekip içinde yürür. Kod Git ile sürümlenir, kritik akışlar Playwright testleriyle korunur, yayın Docker konteynerleriyle tekrarlanabilir biçimde yapılır.

• KVKK baştan tasarlanır.
• Ölçülebilir hedefler konur: arama ve WhatsApp tıklaması, form talebi, işlem süresi.
• Her değişiklik önce test ortamında denenir.

Türkiye'nin 81 ilindeki işletmelerle uzaktan çalışıyoruz: görüntülü toplantı, ekran paylaşımlı demo ve ortak proje panosu. Donanım kurulumu, depo barkod sistemi kurulumu, saha keşfi veya kullanıcı eğitimi gereken işlerde yerinde çalışma planlanır.

08Uzman desteği ne zaman şart olur?

API geliştirme işlerinde bazı durumlar plansız ilerlerse sonradan pahalıya mal olur:

• Çift kayıt oluşuyor: eşsiz anahtar yok.
• Veriler iki kez giriliyor: sistemler bağlı değil.
• Kişisel veya finansal verinin işlendiği akışlar
• Birden fazla sistemle entegrasyon gerektiren işler

SSSSık sorulan sorular

→İlgili sayfalar

Bu sayfada geçen kavramlar

• REST
• kimlik doğrulama
• dokümantasyon
• CSV
• webhook
• token
• yeniden deneme
• JSON
• senkronizasyon
• OAuth
• Diyarbakır
• Sur