Suşehri'nde özel API servisi yaptırmak

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

Özel API servisi projelerinde ihtiyaca göre şu özellikler bir araya getirilir:

• kota
• sürümleme
• izleme

Bu projeler çoğu zaman API yönetim paneli ve geliştirici portalı, webhook servisi ve kimlik doğrulama ve SSO gibi işlerle birlikte ele alınır.

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

Entegrasyon talepleri tek tek karşılandığında

Standart bir API ve dokümantasyon, her iş ortağı için ayrı geliştirme yapma ihtiyacını azaltır.

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

• hata kodu standardı.
• webhook imza doğrulaması
• kimlik doğrulama (API anahtarı, OAuth 2.0)

04Sık karşılaşılan durumlar

05Suşehri için uzaktan ve yerinde çalışma

Suşehri, Sivas iline bağlı bir ilçedir ve PTT adres verisine göre 124 mahalle ve köy kaydından oluşur.

Mesafe yazılım işinin önünde engel değildir: Suşehri'ndeki 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.

Sivas genelinde Sivas Altınyayla, Kangal ve Zara gibi diğer ilçelerdeki işletmelerle de aynı uzaktan çalışma düzeniyle ilerlenir.

06Ç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: Ekranlar, raporlar ve entegrasyonlar için gerçek örnekler üzerinden ihtiyaç listesi çıkarılır.
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: Tıklanabilir bir prototiple kullanıcı yolculuğu baştan sona denenir.
5. Geliştirme ve test: Kod sürüm kontrolüyle yönetilir, kritik akışlar otomatik testlerle korunur.
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: Hata bildirimleri kayıt altına alınır, güncellemeler test edilerek uygulanır.

07Rakamlarla örnek bir senaryo

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.

• Kaynak kod ve veri işletmeye teslim edilir.
• KVKK baştan tasarlanır.
• Kapsam ve teslim kriterleri yazılı olur.

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.

09Uzman desteği ne zaman şart olur?

Ö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
• OAuth 2.0
• Swagger
• webhook
• Sivas
• Suşehri