Pertek'te 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:

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

İ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?

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

Ara katman sayesinde eski sistem çalışmaya devam ederken verisi yeni süreçlere açı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.

Sistemler birbirinden habersiz çalıştığında

Stok, cari, sipariş ve fatura gibi kayıtlar ortak kurallarla eşitlenir; herkes aynı veriyi görür.

03API geliştirme planlarken bilinmesi gerekenler

• Hangi veri, hangi yönde, ne sıklıkla akacak?
• 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ü.
• Lisanslı ürünlerde (Logo, Mikro, Netsis, Nebim, SAP) entegrasyon, ürünün resmî entegrasyon araçları ve lisans koşullarıyla yapılır.

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

05Pertek için uzaktan ve yerinde çalışma

Pertek, Tunceli iline bağlı bir ilçedir ve PTT adres verisine göre 116 mahalle ve köy kaydından oluşur.

Yazılım projelerinde analiz, tasarım ve geliştirme çoğunlukla uzaktan, görüntülü toplantılarla yürür; Pertek'teki 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 Çemişgezek, Hozat ve Tunceli Merkez ilçeleri için de API geliştirme talepleri değerlendirilir; toplantılar uzaktan yapılır.

06İlk görüşmeden yayına

1. İlk görüşme: Telefon, WhatsApp veya form üzerinden ihtiyacınızı ve mevcut durumu dinleriz.
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: Hata bildirimleri kayıt altına alınır, güncellemeler test edilerek uygulanır.

07Rakamlarla örnek bir senaryo

08Ekip 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.

• Her değişiklik önce test ortamında denenir.
• Alan adı ve sunucu hesapları işletme adına açılır.
• Yayın sonrası bakım ve destek planlanır.

Türkiye'nin 81 ilindeki işletmelerle uzaktan çalışıyoruz; Tunceli de bunlardan biri.

09Uzman desteği ne zaman şart olur?

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

• Entegrasyon sessizce durmuş: izleme yok.
• Çift kayıt oluşuyor: eşsiz anahtar yok.
• 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
• OAuth
• senkronizasyon
• JSON
• Tunceli
• Pertek