Maden'de API geliştirme yaptırmak

01API geliştirme ile neler yapılır?

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

• sürümleme
• dokümantasyon
• 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

• Hangi veri, hangi yönde, ne sıklıkla akacak?
• Lisanslı ürünlerde (Logo, Mikro, Netsis, Nebim, SAP) entegrasyon, ürünün resmî entegrasyon araçları ve lisans koşullarıyla yapılır.
• Hata durumunda yeniden deneme, kuyruk ve bildirim kurgulanır.

04Sık karşılaşılan durumlar

05Maden'de API geliştirme: çalışma düzeni

PTT kayıtlarında Maden ilçesine bağlı 114 yerleşim bulunur: 2 mahalle ile 112 köy ve köy yerleşimi.

Maden'de 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.

Elazığ genelinde Kovancılar, Sivrice ve Keban gibi diğer ilçelerdeki işletmelerle de aynı uzaktan çalışma düzeniyle ilerlenir.

06Proje nasıl ilerler?

1. İlk görüşme: Kısa bir görüşmede ne yapmak istediğinizi, bugün nasıl çalıştığınızı ve öncelikli sorunu konuşuruz.
2. Analiz: Süreç, kullanıcı rolleri, kullandığınız Excel veya eski sistem örnekleri ve bağlanacak sistemler incelenir.
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: Her teslimde çalışan bir sürüm test ortamında paylaşılır; hatalar canlıya çıkmadan giderilir.
6. Yayın, veri aktarımı ve eğitim: Mevcut veriler aktarılır, sistem yayına alınır ve kullanıcılara eğitim verilir.
7. Bakım ve destek: Yayın sonrası izleme, güncelleme ve geliştirme talepleri bakım planıyla sürdürülür.

07Örnek kapsam hesabı

08Çalışma düzenimiz

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.

• Her değişiklik önce test ortamında denenir.
• Kaynak kod ve veri işletmeye teslim edilir.
• Kapsam ve teslim kriterleri yazılı olur.

Türkiye'nin 81 ilindeki işletmelerle uzaktan çalışıyoruz; Elazığ da bunlardan biri.

09Uzman 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
• senkronizasyon
• SOAP
• OAuth
• Elazığ
• Maden