Damal'da API geliştirme firması seçerken nelere bakılmalı?

01API geliştirme firması seçerken bakılacak ölçütler

İletişim düzeni

Kiminle, hangi kanaldan ve hangi sıklıkta görüşüleceği baştan bellidir.

Kaynak kod sahipliği

Kaynak kodun ve verinin işletmeye teslim edileceği sözleşmede yazmalıdır.

Dokümantasyon

Kurulum, mimari ve kullanım bilgisi yazılı olarak teslim edilmelidir.

Referans kontrol yöntemi

Referans isterken çalışan bir projeyi görmek ve o işletmeyle doğrudan konuşmak, yalnız logo listesine bakmaktan daha güvenilirdir.

Test ortamı

Değişikliklerin canlıya çıkmadan denendiği ayrı bir ortam olmalıdır.

Bakım koşulları

Yayın sonrası hata düzeltme ve güncellemenin nasıl yürüyeceği tanımlıdır.

02Teklif görüşmesinde sorulacak sorular

• KVKK açısından erişim yetkileri ve kayıtlar nasıl tasarlanacak?
• Yedekleme nasıl yapılacak, geri yükleme denenecek mi?
• Yayın sonrası hata düzeltme ve bakım koşulları neler?
• Kaynak kod ve veri kime ait olacak, teslimde nasıl verilecek?
• Kapsam dışı değişiklik talepleri nasıl yönetilecek?
• Dokümantasyon ve kullanıcı eğitimi kapsamda mı?

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.
• 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ü.

04API geliştirme hangi ihtiyaca cevap verir?

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.

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.

05Kırmızı bayraklar

• Test ortamı ve aşamalı teslim olmadan tek seferde teslim vaadi
• Ödemenin tamamını iş başlamadan isteyen plan
• Kaynak kodu teslim etmeyeceğini söyleyen veya sözleşmede belirtmeyen firma
• Analiz yapmadan, birkaç dakikalık görüşmeyle kesin fiyat veren teklif
• Alan adını ve sunucu hesabını kendi adına açmak isteyen yaklaşım

06Ardahan dışındaki bir firmayla nasıl çalışılır?

Uzaktan çalışmanın anahtarı düzenli iletişimdir: haftalık kısa toplantılar, ortak proje panosu ve her aşamada test ortamında çalışan bir sürüm.

• Görüntülü toplantı ve ekran paylaşımı
• Ortak proje panosu ve yazılı karar kaydı
• Her aşamada test ortamında deneme
• Kurulum, saha keşfi veya eğitim gerektiğinde yerinde çalışma

07Damal'da API geliştirme için çalışma biçimimiz

Damal, Ardahan iline bağlı bir ilçedir ve PTT adres verisine göre 19 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; Damal'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.

Ardahan genelinde Göle, Ardahan Merkez ve Posof gibi diğer ilçelerdeki işletmelerle de aynı uzaktan çalışma düzeniyle ilerlenir.

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.

• Ölçülebilir hedefler konur: arama ve WhatsApp tıklaması, form talebi, işlem süresi.
• KVKK baştan tasarlanır.
• Her değişiklik önce test ortamında denenir.

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

09Örnek hesap

SSSSık sorulan sorular

→İlgili sayfalar

Bu sayfada geçen kavramlar

• REST
• kimlik doğrulama
• dokümantasyon
• CSV
• webhook
• token
• yeniden deneme
• senkronizasyon
• middleware
• Ardahan
• Damal