Pervari'de ö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
• izleme
• sürümleme

Ö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.

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.

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ı.
• oran sınırı ve kota
• webhook imza doğrulaması

04Pervari'de özel API servisi: çalışma düzeni

Pervari, Siirt iline bağlı bir ilçedir ve PTT adres verisine göre 67 mahalle ve köy kaydından oluşur.

Yazılım projelerinde analiz, tasarım ve geliştirme çoğunlukla uzaktan, görüntülü toplantılarla yürür; Pervari'deki 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.

Siirt genelinde Baykan, Kurtalan ve Eruh gibi diğer ilçelerdeki işletmelerle de aynı uzaktan çalışma düzeniyle ilerlenir.

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: Ekranlar, raporlar ve entegrasyonlar için gerçek örnekler üzerinden ihtiyaç listesi çıkarılır.
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: Ekran akışları ve tasarımlar hazırlanır, onayınızdan sonra geliştirmeye geçilir.
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.

06Rakamlarla örnek bir senaryo

07Nasıl çalışıyoruz?

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.

• KVKK baştan tasarlanır.
• Yayın sonrası bakım ve destek planlanı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.

08Uzman desteği ne zaman şart olur?

Ö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.
• 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
• OAuth 2.0
• webhook
• Swagger
• API anahtarı
• Siirt
• Pervari