Güroymak'ta API geliştirme firması seçerken nelere bakılmalı?

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

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.

KVKK yaklaşımı

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

Kaynak kod sahipliği

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

Yazılı kapsam

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

02Teklif görüşmesinde sorulacak sorular

• Kapsam dışı değişiklik talepleri nasıl yönetilecek?
• Barındırma, alan adı, lisans ve üçüncü taraf servis giderleri kimde olacak?
• Yedekleme nasıl yapılacak, geri yükleme denenecek mi?
• Geliştirme sırasında deneyebileceğim bir test ortamı olacak mı?
• Yayın sonrası hata düzeltme ve bakım koşulları neler?
• Dokümantasyon ve kullanıcı eğitimi kapsamda mı?

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ü.
• Lisanslı ürünlerde (Logo, Mikro, Netsis, Nebim, SAP) entegrasyon, ürünün resmî entegrasyon araçları ve lisans koşullarıyla yapılır.
• Hata durumunda yeniden deneme, kuyruk ve bildirim kurgulanı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.

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

• Ö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ı
• 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

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

07Güroymak'ta API geliştirme için çalışma biçimimiz

Güroymak'ın PTT verisindeki 61 yerleşim kaydı 4 farklı posta koduna dağılır.

Mesafe yazılım işinin önünde engel değildir: Güroymak'taki ekiplerle görüntülü görüşme, ekran paylaşımı ve test ortamı bağlantısıyla çalışılır; cihaz kurulumu veya saha keşfi gerekirse yerinde ziyaret planlanır.

Aynı ildeki Ahlat, Mutki ve Bitlis Merkez ilçeleri için de API geliştirme talepleri değerlendirilir; toplantılar uzaktan yapılır.

08Ç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.

• Kapsam ve teslim kriterleri yazılı olur.
• Her değişiklik önce test ortamında denenir.
• Yayın sonrası bakım ve destek planlanı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
• SOAP
• middleware
• yeniden deneme
• senkronizasyon
• Bitlis
• Güroymak