Köşk'te özel API servisi firması seçerken nelere bakılmalı?

01Özel API servisi firması seçerken bakılacak ölçütler

İletişim düzeni

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

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.

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.

Bakım koşulları

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

Dokümantasyon

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

02Teklif görüşmesinde sorulacak sorular

• Yedekleme nasıl yapılacak, geri yükleme denenecek mi?
• Ödeme planı teslim aşamalarına bağlı mı?
• Geliştirme sırasında deneyebileceğim bir test ortamı olacak mı?
• Kaynak kod ve veri kime ait olacak, teslimde nasıl verilecek?
• Barındırma, alan adı, lisans ve üçüncü taraf servis giderleri kimde olacak?
• Kapsam ve teslim kriterleri yazılı olarak belirtiliyor mu?

03Özel API servisi planlarken bilinmesi gerekenler

• OpenAPI dokümantasyonu
• webhook imza doğrulaması
• hata kodu standardı.

04Özel API servisi hangi ihtiyaca cevap verir?

Verinizi iş ortaklarına açmak istediğinizde

Özel API servisi ile veri, yetki ve kota kontrolüyle güvenli biçimde dış sistemlere sunulur.

Sürümleme gerektiğinde

Sürümleme, özel API servisi 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
• 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
• Ödemenin tamamını iş başlamadan isteyen plan
• Analiz yapmadan, birkaç dakikalık görüşmeyle kesin fiyat veren teklif

06Aydın 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

07Köşk'te özel API servisi için çalışma biçimimiz

Köşk, Aydın iline bağlı bir ilçedir ve PTT adres verisine göre 28 mahalleden oluşur. Büyükşehirlerde merkez ve şube yapısıyla çalışan işletmeler için özel API servisi tasarımında merkez-şube yetki yapısı ve birleşik raporlama öne çıkar.

Yazılım projelerinde analiz, tasarım ve geliştirme çoğunlukla uzaktan, görüntülü toplantılarla yürür; Köşk'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.

Aydın genelinde Didim, Karpuzlu ve Karacasu gibi diğer ilçelerdeki işletmelerle de aynı uzaktan çalışma düzeniyle ilerlenir.

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.

• 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; Aydın da bunlardan biri.

09Örnek hesap

SSSSık sorulan sorular

→İlgili sayfalar

Bu sayfada geçen kavramlar

• sürümleme
• kota
• izleme
• SSO
• rate limit
• OpenAPI
• Swagger
• SDK
• webhook
• geliştirici portalı
• Aydın
• Köşk