Ergani'de API geliştirme firması seçerken nelere bakılmalı?

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

Bakım koşulları

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

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.

Test ortamı

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

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.

02Teklif görüşmesinde sorulacak sorular

• Barındırma, alan adı, lisans ve üçüncü taraf servis giderleri kimde olacak?
• Ödeme planı teslim aşamalarına bağlı mı?
• Geliştirme sırasında deneyebileceğim bir test ortamı olacak mı?
• Yayın sonrası hata düzeltme ve bakım koşulları neler?
• Yedekleme nasıl yapılacak, geri yükleme denenecek mi?
• KVKK açısından erişim yetkileri ve kayıtlar nasıl tasarlanacak?

03API geliştirme planlarken bilinmesi gerekenler

• Değişikliklere karşı izleme ve bakım planlanı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

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

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

Yazılım projelerinde analiz, tasarım ve geliştirme çoğunlukla uzaktan yürür. Ergani'de bulunan bir işletme olarak görüntülü toplantı, ekran paylaşımlı demo ve test ortamı bağlantısıyla süreci yakından izleyebilirsiniz.

• 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

07Ergani'de API geliştirme için çalışma biçimimiz

Ergani'nin PTT verisindeki 107 yerleşim kaydı 1 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.

Ergani'de 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.

Diyarbakır genelinde Çüngüş, Eğil ve Silvan gibi diğer ilçelerdeki işletmelerle de aynı uzaktan çalışma düzeniyle ilerlenir.

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.

• Her değişiklik önce test ortamında denenir.
• Kapsam ve teslim kriterleri yazılı olur.
• Alan adı ve sunucu hesapları işletme adına açılır.

Türkiye'nin 81 ilindeki işletmelerle uzaktan çalışıyoruz; Diyarbakır 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
• JSON
• SOAP
• Diyarbakır
• Ergani