Çağlayancerit'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

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?

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

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

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.

03Özel API servisi planlarken bilinmesi gerekenler

• kimlik doğrulama (API anahtarı, OAuth 2.0)
• hata kodu standardı.
• oran sınırı ve kota

04Çağlayancerit'te özel API servisi: çalışma düzeni

Çağlayancerit'in PTT verisindeki 19 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.

Mesafe yazılım işinin önünde engel değildir: Çağlayancerit'teki 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 Onikişubat, Türkoğlu ve Elbistan ilçeleri için de özel API servisi talepleri değerlendirilir; toplantılar uzaktan yapılır.

05Proje nasıl ilerler?

1. İlk görüşme: Kısa bir görüşmede ne yapmak istediğinizi, bugün nasıl çalıştığınızı ve öncelikli sorunu konuşuruz.
2. Analiz: Süreç, kullanıcı rolleri, kullandığınız Excel veya eski sistem örnekleri ve bağlanacak sistemler incelenir.
3. Kapsam ve yazılı teklif: Modüller, aşamalar ve teslim kriterleri yazılı bir kapsamla belirlenir; teklif bu kapsama göre verilir.
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: 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

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.

• Ölçülebilir hedefler konur: arama ve WhatsApp tıklaması, form talebi, işlem süresi.
• KVKK baştan tasarlanır.
• Alan adı ve sunucu hesapları işletme adına açılır.

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.

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.
• Eski sürümü kullananlar bozuluyor: sürümleme ve geçiş takvimi yok.
• 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
• Swagger
• API anahtarı
• geliştirici portalı
• Kahramanmaraş
• Çağlayancerit