Hamur'da API geliştirme yaptırmak

01API geliştirme nedir, kimler için uygun?

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

• kimlik doğrulama
• dokümantasyon
• sürümleme
• 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?

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

• Hata durumunda yeniden deneme, kuyruk ve bildirim kurgulanır.
• Lisanslı ürünlerde (Logo, Mikro, Netsis, Nebim, SAP) entegrasyon, ürünün resmî entegrasyon araçları ve lisans koşullarıyla yapılır.
• Değişikliklere karşı izleme ve bakım planlanır.

04Hamur için uzaktan ve yerinde çalışma

PTT kayıtlarında Hamur ilçesine bağlı 105 yerleşim bulunur: 4 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; Hamur'daki 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 Tutak, Ağrı Merkez ve Taşlıçay ilçeleri için de API geliştirme talepleri değerlendirilir; toplantılar uzaktan yapılır.

05Proje 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: 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: Kod sürüm kontrolüyle yönetilir, kritik akışlar otomatik testlerle korunur.
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.

06Örnek planlama hesabı

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

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

Türkiye'nin 81 ilindeki işletmelerle uzaktan çalışıyoruz: görüntülü toplantı, ekran paylaşımlı demo ve ortak proje panosu. Donanım kurulumu, depo barkod sistemi kurulumu, saha keşfi veya kullanıcı eğitimi gereken işlerde yerinde çalışma planlanır.

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
• JSON
• senkronizasyon
• log
• Ağrı
• Hamur