Köşk'te özel API servisi yaptırmak

01Özel API servisi ile neler yapılır?

Her işletmenin ihtiyacı farklıdır; yine de çoğu özel API servisi projesinde şu başlıklar konuşulur:

• izleme
• kota
• sürümleme

İhtiyaca göre API yönetim paneli ve geliştirici portalı, webhook servisi ve kimlik doğrulama ve SSO da aynı yol haritasına eklenebilir.

02Hangi durumlarda özel API servisi yaptırılır?

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.

Oturum açma her üründe ayrı yönetildiğinde

Merkezi kimlik doğrulama ve SSO ile kullanıcı yönetimi sadeleşir.

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.

03Özel API servisi planlarken bilinmesi gerekenler

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

04Köşk'te özel API servisi: çalışma düzeni

Köşk'ün PTT verisindeki 28 yerleşim kaydı 1 farklı posta koduna dağılır. Birden fazla ilçede ekibi veya şubesi olan işletmelerde özel API servisi için kullanıcı rolleri, şube bazlı görünürlük ve merkezi raporlar birlikte planlanır.

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.

Aynı ildeki İncirliova, Buharkent ve Karacasu ilçeleri için de özel API servisi talepleri değerlendirilir; toplantılar uzaktan yapılır.

05Çalışma adımları

1. İlk görüşme: İlk temas telefonla ya da WhatsApp'tan olur; işin kapsamını anlamak için birkaç temel soru sorarız.
2. Analiz: Kimin neyi göreceği, hangi verinin nereden geleceği ve hangi işin önce çözüleceği netleştirilir.
3. Kapsam ve yazılı teklif: Hangi işin hangi aşamada teslim edileceği ve neyin kapsam dışı olduğu teklifte açıkça yazılır.
4. Tasarım ve prototip: Temel ekranlar çizilir; kullanıcıların geri bildirimiyle akış sadeleştirilir.
5. Geliştirme ve test: Her teslimde çalışan bir sürüm test ortamında paylaşılır; hatalar canlıya çıkmadan giderilir.
6. Yayın, veri aktarımı ve eğitim: Mevcut veriler aktarılır, sistem yayına alınır ve kullanıcılara eğitim verilir.
7. Bakım ve destek: Yeni ihtiyaçlar sürüm planına alınır; sistem kullanıldıkça geliştirilir.

06Örnek kapsam hesabı

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

08Hangi durumlarda profesyonel destek gerekir?

Özel API servisi işlerinde bazı durumlar plansız ilerlerse sonradan pahalıya mal olur:

• API yoğunlukta yavaşlıyor: kota ve önbellek yok, sorgular optimize değil.
• İş ortakları API'yi yanlış kullanıyor: dokümantasyon eksik veya güncel değil.
• Kişisel veya finansal verinin işlendiği akışlar
• Birden fazla sistemle entegrasyon gerektiren işler

SSSSık sorulan sorular

→İlgili sayfalar

Bu sayfada geçen kavramlar

• sürümleme
• kota
• izleme
• SSO
• rate limit
• OpenAPI
• webhook
• OAuth 2.0
• API anahtarı
• geliştirici portalı
• Aydın
• Köşk