Hasankeyf'te 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.

Kaynak kod sahipliği

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

KVKK yaklaşımı

Kişisel veri, erişim yetkisi ve kayıt tutma tasarımın parçası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.

Dokümantasyon

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

02Teklif görüşmesinde sorulacak sorular

• Dokümantasyon ve kullanıcı eğitimi kapsamda mı?
• Ödeme planı teslim aşamalarına bağlı mı?
• 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?
• Yayın sonrası hata düzeltme ve bakım koşulları neler?
• Kapsam ve teslim kriterleri yazılı olarak belirtiliyor mu?

03API geliştirme planlarken bilinmesi gerekenler

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

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

• Kaynak kodu teslim etmeyeceğini söyleyen veya sözleşmede belirtmeyen firma
• Test ortamı ve aşamalı teslim olmadan tek seferde teslim vaadi
• Ödemenin tamamını iş başlamadan isteyen plan
• Analiz yapmadan, birkaç dakikalık görüşmeyle kesin fiyat veren teklif
• Garanti edilen sıralama, kesin satış veya "en iyi" iddiaları

06Batman 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

07Hasankeyf'te API geliştirme için çalışma biçimimiz

Hasankeyf, Batman iline bağlı bir ilçedir ve PTT adres verisine göre 30 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; Hasankeyf'teki 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 Sason, Beşiri ve Batman Merkez ilçeleri için de API geliştirme talepleri değerlendirilir; toplantılar uzaktan yapılır.

08Çalışma düzenimiz

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.

• Kapsam ve teslim kriterleri yazılı olur.
• Alan adı ve sunucu hesapları işletme adına açılır.
• KVKK baştan tasarlanır.

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.

09Örnek hesap

SSSSık sorulan sorular

→İlgili sayfalar

Bu sayfada geçen kavramlar

• REST
• kimlik doğrulama
• dokümantasyon
• CSV
• webhook
• token
• XML
• yeniden deneme
• Batman
• Hasankeyf