Tutak'ta 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
• REST
• dokümantasyon
• kimlik doğrulama

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?

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.

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

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

05Tutak'ta API geliştirme: çalışma düzeni

PTT kayıtlarında Tutak ilçesine bağlı 106 yerleşim bulunur: 5 mahalle ile 101 köy ve köy yerleşimi.

Yazılım projelerinde analiz, tasarım ve geliştirme çoğunlukla uzaktan, görüntülü toplantılarla yürür; Tutak'taki 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.

Ağrı genelinde Taşlıçay, Hamur ve Diyadin gibi diğer ilçelerdeki işletmelerle de aynı uzaktan çalışma düzeniyle ilerlenir.

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: 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: 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.

07Örnek planlama hesabı

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.

• Alan adı ve sunucu hesapları işletme adına açılır.
• Kaynak kod ve veri işletmeye teslim edilir.
• Ölçülebilir hedefler konur: arama ve WhatsApp tıklaması, form talebi, işlem süresi.

Türkiye'nin 81 ilindeki işletmelerle uzaktan çalışıyoruz; Ağrı 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:

• 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
• log
• OAuth
• JSON
• Ağrı
• Tutak