Hekimhan'da ö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:

• sürümleme
• izleme
• kota

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?

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

• oran sınırı ve kota
• webhook imza doğrulaması
• hata kodu standardı.

04Hekimhan için uzaktan ve yerinde çalışma

Hekimhan'ın PTT verisindeki 65 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; Hekimhan'daki 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 Malatya Kale, Malatya Yeşilyurt ve Battalgazi 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: 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: Geliştirme aşamalı ilerler; her aşama test ortamında denenip onaylanır.
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

07Çalışma düzenimiz

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.

• Kapsam ve teslim kriterleri yazılı olur.
• Alan adı ve sunucu hesapları işletme adına açılır.
• Ölçülebilir hedefler konur: arama ve WhatsApp tıklaması, form talebi, işlem süresi.

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:

• Eski sürümü kullananlar bozuluyor: sürümleme ve geçiş takvimi yok.
• Webhook bildirimleri kayboluyor: yeniden deneme ve teslim kaydı 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
• geliştirici portalı
• Swagger
• Malatya
• Hekimhan