Hamur'da 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.

Kaynak kod sahipliği

Kaynak kodun ve verinin işletmeye teslim edileceği sözleşmede yazmalı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.

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.

İletişim düzeni

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

02Teklif görüşmesinde sorulacak sorular

• Kaynak kod ve veri kime ait olacak, teslimde nasıl verilecek?
• Dokümantasyon ve kullanıcı eğitimi kapsamda mı?
• Yedekleme nasıl yapılacak, geri yükleme denenecek mi?
• KVKK açısından erişim yetkileri ve kayıtlar nasıl tasarlanacak?
• Geliştirme sırasında deneyebileceğim bir test ortamı olacak mı?
• Kapsam ve teslim kriterleri yazılı olarak belirtiliyor mu?

03API geliştirme planlarken bilinmesi gerekenler

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

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

Stok, cari, sipariş ve fatura gibi kayıtlar ortak kurallarla eşitlenir; herkes aynı veriyi görür.

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.

05Kırmızı bayraklar

• Kaynak kodu teslim etmeyeceğini söyleyen veya sözleşmede belirtmeyen firma
• Garanti edilen sıralama, kesin satış veya "en iyi" iddiaları
• Ödemenin tamamını iş başlamadan isteyen plan
• 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

06Ağrı 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

07Hamur'da API geliştirme için çalışma biçimimiz

Hamur'un PTT verisindeki 105 yerleşim kaydı 2 farklı posta koduna dağılır.

Mesafe yazılım işinin önünde engel değildir: Hamur'daki 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 Ağrı Merkez, Diyadin ve Doğubayazıt ilçeleri için de API geliştirme talepleri değerlendirilir; toplantılar uzaktan yapılır.

08Nasıl çalışıyoruz?

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.
• Kaynak kod ve veri işletmeye teslim edilir.
• Her değişiklik önce test ortamında denenir.

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
• JSON
• yeniden deneme
• Ağrı
• Hamur