Çaldıran'da özel API servisi yaptırmak

01Özel API servisi nedir, kimler için uygun?

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

• kota
• sürümleme
• izleme

Özel API servisi ile birlikte sık planlanan işler arasında API yönetim paneli ve geliştirici portalı, webhook servisi ve kimlik doğrulama ve SSO bulunur.

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.

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.

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

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

03Özel API servisi planlarken bilinmesi gerekenler

• OpenAPI dokümantasyonu
• hata kodu standardı.
• kimlik doğrulama (API anahtarı, OAuth 2.0)

04Çaldıran'da özel API servisi: çalışma düzeni

Çaldıran, Van iline bağlı bir ilçedir ve PTT adres verisine göre 70 mahalleden oluşur. 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.

Çaldıran'da 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.

Van genelinde Özalp, Çatak ve Gevaş gibi diğer ilçelerdeki işletmelerle de aynı uzaktan çalışma düzeniyle ilerlenir.

05Proje nasıl ilerler?

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: Ekran akışları ve tasarımlar hazırlanır, onayınızdan sonra geliştirmeye geçilir.
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: Veri aktarımı doğrulandıktan sonra yayına geçilir; ekip için kısa kullanım kılavuzu hazırlanır.
7. Bakım ve destek: Yayın sonrası izleme, güncelleme ve geliştirme talepleri bakım planıyla sürdürülür.

06Rakamlarla örnek bir senaryo

07Ekip ve çalışma biçimimiz

Çalışma düzenimizde sürüm kontrolü, otomatik testler, konteyner tabanlı yayın ve izleme araçları standarttır; her değişiklik bu adımlardan geçerek canlıya çıkar.

• Ölçülebilir hedefler konur: arama ve WhatsApp tıklaması, form talebi, işlem süresi.
• Kaynak kod ve veri işletmeye teslim edilir.
• Kapsam ve teslim kriterleri yazılı olur.

Türkiye'nin 81 ilindeki işletmelerle uzaktan çalışıyoruz; Van da bunlardan biri.

08Hangi durumlarda profesyonel destek gerekir?

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

• İş ortakları API'yi yanlış kullanıyor: dokümantasyon eksik veya güncel değil.
• API yoğunlukta yavaşlıyor: kota ve önbellek yok, sorgular optimize 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
• geliştirici portalı
• Swagger
• Van
• Çaldıran