Kilis Merkez'de API geliştirme yaptırmak

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

Her işletmenin ihtiyacı farklıdır; yine de çoğu API geliştirme projesinde şu başlıklar konuşulur:

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

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

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.

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

• Değişikliklere karşı izleme ve bakım planlanı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ü.
• Kimlik ve yetki bilgileri güvenli saklanır; erişim en az yetkiyle verilir.

04Kilis Merkez için uzaktan ve yerinde çalışma

Kilis Merkez'in PTT verisindeki 155 yerleşim kaydı 2 farklı posta koduna dağılır. Bu kayıtlardan 1 tanesi organize sanayi veya serbest bölge kaydıdır.

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

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

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: Kimin neyi göreceği, hangi verinin nereden geleceği ve hangi işin önce çözüleceği netleştirilir.
3. Kapsam ve yazılı teklif: Hangi işin hangi aşamada teslim edileceği ve neyin kapsam dışı olduğu teklifte açıkça yazılır.
4. Tasarım ve prototip: Tıklanabilir bir prototiple kullanıcı yolculuğu baştan sona denenir.
5. Geliştirme ve test: Geliştirme aşamalı ilerler; her aşama test ortamında denenip onaylanır.
6. Yayın, veri aktarımı ve eğitim: Canlıya geçiş planlı bir zamanda yapılır; ilk günlerde kullanım yakından izlenir.
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

07Ç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.
• Ölçülebilir hedefler konur: arama ve WhatsApp tıklaması, form talebi, işlem süresi.
• KVKK baştan tasarlanır.

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

08Uzman desteği ne zaman şart olur?

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

• Veriler iki kez giriliyor: sistemler bağlı değil.
• Entegrasyon sessizce durmuş: izleme 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
• XML
• yeniden deneme
• Kilis
• Merkez