Güçlükonak'ta ö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:

• sürümleme
• kota
• 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?

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.

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.

03Özel API servisi planlarken bilinmesi gerekenler

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

04Güçlükonak için uzaktan ve yerinde çalışma

Güçlükonak'ın PTT verisindeki 30 yerleşim kaydı 3 farklı posta koduna dağılır.

Güçlükonak'ta 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.

Aynı ildeki Şırnak Merkez, İdil ve Cizre 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: 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: 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: 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: Hata bildirimleri kayıt altına alınır, güncellemeler test edilerek uygulanır.

06Örnek kapsam hesabı

07Nasıl çalışıyoruz?

Projeler tasarım, yazılım geliştirme, test ve yayın adımlarını kapsayan bir ekiple yürütülür. Sürüm kontrolü (Git), otomatik testler (Playwright), konteyner tabanlı yayın (Docker), sürekli entegrasyon ve izleme araçları standart çalışma düzenimizin parçasıdır.

• Kapsam ve teslim kriterleri yazılı olur.
• Her değişiklik önce test ortamında denenir.
• Kaynak kod ve veri işletmeye teslim edilir.

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.

08Uzman 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.
• 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
• webhook
• geliştirici portalı
• Swagger
• Şırnak
• Güçlükonak