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

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

Test ortamı

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

İletişim düzeni

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

Yazılı kapsam

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

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.

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

• Dokümantasyon ve kullanıcı eğitimi kapsamda mı?
• Kapsam dışı değişiklik talepleri nasıl yönetilecek?
• Ödeme planı teslim aşamalarına bağlı mı?
• Kaynak kod ve veri kime ait olacak, teslimde nasıl verilecek?
• Geliştirme sırasında deneyebileceğim bir test ortamı olacak mı?
• KVKK açısından erişim yetkileri ve kayıtlar nasıl tasarlanacak?

03API geliştirme planlarken bilinmesi gerekenler

• Hangi veri, hangi yönde, ne sıklıkla akacak?
• 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ü.

04Kırmızı bayraklar

• 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ı
• Test ortamı ve aşamalı teslim olmadan tek seferde teslim vaadi
• Alan adını ve sunucu hesabını kendi adına açmak isteyen yaklaşım

05Karaman 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

06Ayrancı'da API geliştirme için çalışma biçimimiz

Ayrancı'nın PTT verisindeki 36 yerleşim kaydı 2 farklı posta koduna dağılır.

Ayrancı'da bulunan bir işletmeyle çalışırken toplantılar görüntülü yapılır, her aşama test ortamında paylaşılır ve geri bildirimler ortak panoda toplanır; yerinde bulunmak gereken kurulum ve eğitim adımları ayrıca planlanır.

Aynı ildeki Kazımkarabekir, Başyayla ve Sarıveliler ilçeleri için de API geliştirme talepleri değerlendirilir; toplantılar uzaktan yapılır.

07Çalışma düzenimiz

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.

• Yayın sonrası bakım ve destek planlanı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; Karaman da bunlardan biri.

08Örnek hesap

SSSSık sorulan sorular

→İlgili sayfalar

Bu sayfada geçen kavramlar

• REST
• kimlik doğrulama
• dokümantasyon
• CSV
• webhook
• token
• log
• yeniden deneme
• senkronizasyon
• Karaman
• Ayrancı