İdil'de 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:

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

Bu projeler çoğu zaman API entegrasyonu, ERP entegrasyonu ve CRM entegrasyonu gibi işlerle birlikte ele alınır.

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.

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.

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.
• Hangi veri, hangi yönde, ne sıklıkla akacak?
• Kimlik ve yetki bilgileri güvenli saklanır; erişim en az yetkiyle verilir.

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

05İdil için uzaktan ve yerinde çalışma

İdil'in PTT verisindeki 93 yerleşim kaydı 4 farklı posta koduna dağılır.

Mesafe yazılım işinin önünde engel değildir: İdil'deki 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.

Aynı ildeki Uludere, Güçlükonak ve Silopi ilçeleri için de API geliştirme talepleri değerlendirilir; toplantılar uzaktan yapılır.

06Çalışma adımları

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: 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: Yayın sonrası izleme, güncelleme ve geliştirme talepleri bakım planıyla sürdürülür.

07Rakamlarla örnek bir senaryo

08Nasıl çalışıyoruz?

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.
• Yayın sonrası bakım ve destek planlanır.
• Alan adı ve sunucu hesapları işletme adına açılır.

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

09Hangi durumlarda profesyonel destek gerekir?

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
• log
• kuyruk
• yeniden deneme
• Şırnak
• İdil