Havran'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.

Bakım koşulları

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

Dokümantasyon

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

Yazılı kapsam

Neyin teslim edileceği, neyin kapsam dışı olduğu ve kabul kriterleri belgelenmelidir.

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.

KVKK yaklaşımı

Kişisel veri, erişim yetkisi ve kayıt tutma tasarımın parçasıdır.

02Teklif görüşmesinde sorulacak sorular

• Kapsam ve teslim kriterleri yazılı olarak belirtiliyor mu?
• Geliştirme sırasında deneyebileceğim bir test ortamı olacak mı?
• Kaynak kod ve veri kime ait olacak, teslimde nasıl verilecek?
• Ödeme planı teslim aşamalarına bağlı mı?
• Dokümantasyon ve kullanıcı eğitimi kapsamda mı?
• Yayın sonrası hata düzeltme ve bakım koşulları neler?

03API geliştirme planlarken bilinmesi gerekenler

• Hata durumunda yeniden deneme, kuyruk ve bildirim kurgulanı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ü.
• Değişikliklere karşı izleme ve bakım planlanır.

04API geliştirme hangi ihtiyaca cevap verir?

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.

05Kırmızı bayraklar

• Test ortamı ve aşamalı teslim olmadan tek seferde teslim vaadi
• 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
• Garanti edilen sıralama, kesin satış veya "en iyi" iddiaları
• Alan adını ve sunucu hesabını kendi adına açmak isteyen yaklaşım

06Balıkesir 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

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

Havran'ın PTT verisindeki 34 yerleşim kaydı 2 farklı posta koduna dağılır. Büyükşehirlerde merkez ve şube yapısıyla çalışan işletmeler için API geliştirme tasarımında merkez-şube yetki yapısı ve birleşik raporlama öne çıkar.

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

Balıkesir genelinde Kepsut, Savaştepe ve Dursunbey gibi diğer ilçelerdeki işletmelerle de aynı uzaktan çalışma düzeniyle ilerlenir.

08Nasıl çalışıyoruz?

Projeler tasarım, yazılım geliştirme, test ve yayın adımlarını kapsayan bir ekiple yürütülür. Sürüm kontrolü (Git), otomatik testler (Playwright), konteyner tabanlı yayın (Docker), sürekli entegrasyon ve izleme araçları standart çalışma düzenimizin parçasıdır.

• Alan adı ve sunucu hesapları işletme adına açılır.
• Kapsam ve teslim kriterleri yazılı olur.
• Kaynak kod ve veri işletmeye teslim edilir.

Türkiye'nin 81 ilindeki işletmelerle uzaktan çalışıyoruz; Balıkesir de 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
• OAuth
• Balıkesir
• Havran