Saraykent'te API geliştirme firması seçerken nelere bakılmalı?

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

Kaynak kod sahipliği

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

Test ortamı

Değişikliklerin canlıya çıkmadan denendiği ayrı bir ortam olmalı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.

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.

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

• Geliştirme sırasında deneyebileceğim bir test ortamı olacak mı?
• Kapsam dışı değişiklik talepleri nasıl yönetilecek?
• Dokümantasyon ve kullanıcı eğitimi kapsamda mı?
• Yayın sonrası hata düzeltme ve bakım koşulları neler?
• Kapsam ve teslim kriterleri yazılı olarak belirtiliyor mu?
• Kaynak kod ve veri kime ait olacak, teslimde nasıl verilecek?

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ü.
• Hangi veri, hangi yönde, ne sıklıkla akacak?
• Değişikliklere karşı izleme ve bakım planlanır.

04API geliştirme hangi ihtiyaca cevap verir?

Sistemler birbirinden habersiz çalıştığında

Stok, cari, sipariş ve fatura gibi kayıtlar ortak kurallarla eşitlenir; herkes aynı veriyi görü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

• Analiz yapmadan, birkaç dakikalık görüşmeyle kesin fiyat veren teklif
• Ödemenin tamamını iş başlamadan isteyen plan
• Kaynak kodu teslim etmeyeceğini söyleyen veya sözleşmede belirtmeyen firma
• 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

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

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

Saraykent'in PTT verisindeki 26 yerleşim kaydı 4 farklı posta koduna dağılır.

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

Yozgat genelinde Çekerek, Kadışehri ve Çayıralan 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.
• Ölçülebilir hedefler konur: arama ve WhatsApp tıklaması, form talebi, işlem süresi.
• Alan adı ve sunucu hesapları işletme adına açılır.

Türkiye'nin 81 ilindeki işletmelerle uzaktan çalışıyoruz; Yozgat 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
• middleware
• yeniden deneme
• OAuth
• log
• Yozgat
• Saraykent