Dış sistemlere veri/servis sunan API ürünü.
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:
- kota
- izleme
- sürümleme
İhtiyaca göre API yönetim paneli ve geliştirici portalı, webhook servisi ve kimlik doğrulama ve SSO da aynı yol haritasına eklenebilir.
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.
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
- OpenAPI dokümantasyonu
- webhook imza doğrulaması
- oran sınırı ve kota
04Sık karşılaşılan durumlar
| Durum | Olası neden | Çözüm |
|---|---|---|
| Eski sürümü kullananlar bozuluyor | Sürümleme ve geçiş takvimi yok | Sürümlü uç noktalar ve duyurulu kullanım dışı bırakma |
| İş ortakları API'yi yanlış kullanıyor | Dokümantasyon eksik veya güncel değil | OpenAPI şeması, örnek istekler ve sürüm notları |
| Webhook bildirimleri kayboluyor | Yeniden deneme ve teslim kaydı yok | İmzalı webhook, kuyruk ve teslim logu |
05Bozdoğan'da özel API servisi: çalışma düzeni
Bozdoğan, Aydın iline bağlı bir ilçedir ve PTT adres verisine göre 55 mahalleden oluşur. Büyükşehirlerde merkez ve şube yapısıyla çalışan işletmeler için özel API servisi tasarımında merkez-şube yetki yapısı ve birleşik raporlama öne çıkar.
Yazılım projelerinde analiz, tasarım ve geliştirme çoğunlukla uzaktan, görüntülü toplantılarla yürür; Bozdoğan'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 Didim, Nazilli ve Köşk ilçeleri için de özel API servisi talepleri değerlendirilir; toplantılar uzaktan yapılır.
Özel API servisini planlıyorsanız 0540 003 19 81 numarasını arayın veya WhatsApp'tan ihtiyacınızı birkaç cümleyle yazın; teklif formunu da doldurabilirsiniz.
06İlk görüşmeden yayına
- İlk görüşme: Telefon, WhatsApp veya form üzerinden ihtiyacınızı ve mevcut durumu dinleriz.
- Analiz: Kimin neyi göreceği, hangi verinin nereden geleceği ve hangi işin önce çözüleceği netleştirilir.
- 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.
- Tasarım ve prototip: Temel ekranlar çizilir; kullanıcıların geri bildirimiyle akış sadeleştirilir.
- Geliştirme ve test: Her teslimde çalışan bir sürüm test ortamında paylaşılır; hatalar canlıya çıkmadan giderilir.
- 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.
- Bakım ve destek: Yayın sonrası izleme, güncelleme ve geliştirme talepleri bakım planıyla sürdürülür.
Notsürümleme stratejisi
07Rakamlarla örnek bir senaryo
Örnek: günlük senkronizasyon isteği
- Ürün sayısı
- 4.000
- Günlük değişim oranı
- %13
- Kanal sayısı
- 6
- Günlük güncelleme isteği
- 3.120
- Saatlik ortalama
- 130
Oran sınırları platformca belirlenir; istekler kuyrukla güne dağıtılır. Not: örnek hesaptır; kesin plan analizde çıkar.
08Nası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.
- Ölçülebilir hedefler konur: arama ve WhatsApp tıklaması, form talebi, işlem süresi.
- Kapsam ve teslim kriterleri yazılı olur.
- KVKK baştan tasarlanır.
Türkiye'nin 81 ilindeki işletmelerle uzaktan çalışıyoruz; Aydın da bunlardan biri.
09Uzman 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
REST mi GraphQL mi?
Kaynak bazlı, önbelleğe uygun ve geniş araç desteği gereken çoğu iş API'sinde REST yeterlidir. İstemcilerin çok farklı veri kombinasyonları istediği ürünlerde GraphQL değerlendirilir.
Bozdoğan'da bulunuyorum, yerinde görüşme mümkün mü?
İşin büyük bölümü uzaktan yürür: ilk görüşme telefonla, sonraki toplantılar görüntülü yapılır. Kurulum ya da eğitim gerekiyorsa yerinde çalışma takvime eklenir.
Kaynak kod bize mi ait olacak?
Sözleşmede yazılı olarak belirtilir; biz kaynak kodun ve verinin işletmeye teslim edildiği çalışma biçimini öneririz.
Özel API servisi için ilk adım nedir?
Kısa bir görüşmeyle ihtiyacı ve mevcut durumu konuşuruz. 0540 003 19 81 numarasını arayabilir veya WhatsApp'tan birkaç cümleyle yazabilirsiniz.
Özel API servisi için hangi bilgiler hazırlanmalı?
Mevcut sürecin kısa anlatımı, kullanılan dosya ve program örnekleri, kullanıcı sayısı ve sürümleme gibi beklentiler ilk görüşme için yeterlidir; kapsam analizde netleşir.
Özel API servisi sonradan genişletilebilir mi?
Evet. Kota gibi özellikler ilk sürümde olmasa da modüler yapı sayesinde sürüm planıyla eklenebilir.
Özel API servisi hazır program yerine neden yaptırılır?
Hazır programlar genel ihtiyaca göre tasarlanır; işinize özgü kurallar, onay adımları veya entegrasyonlar varsa özel geliştirme bu farkı kapatır.
Sadece Aydın için mi çalışıyorsunuz?
Evet. Askadar Yazılım, Türkiye'nin 81 ilindeki işletmelerle uzaktan çalışır; gerektiğinde yerinde çalışma ayrıca planlanır.
→İlgili sayfalar
Özel API Servisi hakkında diğer konular
- Özel API servisi geliştirme süreciAnalizden yayına aşamalar
- Özel API servisi geçiş ve veri aktarımıExcel'den veya eski sistemden geçiş
- Özel API servisi KOBİ'ler içinKüçük ve orta işletmeler için yol haritası
- Özel API servisi güvenlik ve KVKK uyumuYetki, yedek, log ve KVKK
- Özel API servisi fiyatlarıMaliyeti belirleyen kalemler ve teklif karşılaştırma
Bozdoğan'da ilgili hizmetler
Aydın içindeki diğer ilçeler
Bu sayfada geçen kavramlar
- sürümleme
- kota
- izleme
- SSO
- rate limit
- OpenAPI
- webhook
- OAuth 2.0
- Aydın
- Bozdoğan