Dış sistemlere veri/servis sunan API ürünü.
01Özel API servisi ile neler yapılır?
Özel API servisi projelerinde ihtiyaca göre şu özellikler bir araya getirilir:
- kota
- sürümleme
- izleme
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.
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
- oran sınırı ve kota
- kimlik doğrulama (API anahtarı, OAuth 2.0)
- hata kodu standardı.
04Sık karşılaşılan durumlar
| Durum | Olası neden | Çözüm |
|---|---|---|
| İş 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 |
| 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 |
05İstanbul için uzaktan ve yerinde çalışma
Marmara Bölgesi illerinden İstanbul (plaka 34), PTT adres verisinde 39 ilçe ve 973 yerleşim kaydıyla yer alır. İstanbul büyükşehir belediyesi olan 30 ilden biridir. Denize kıyısı olan illerdendir. 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.
Mesafe yazılım işinin önünde engel değildir: İstanbul'daki 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.
Marmara Bölgesi'ndeki Kocaeli, Çanakkale ve Bursa gibi illerdeki işletmelerle de 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: İlk temas telefonla ya da WhatsApp'tan olur; işin kapsamını anlamak için birkaç temel soru sorarız.
- Analiz: Süreç, kullanıcı rolleri, kullandığınız Excel veya eski sistem örnekleri ve bağlanacak sistemler incelenir.
- Kapsam ve yazılı teklif: Modüller, aşamalar ve teslim kriterleri yazılı bir kapsamla belirlenir; teklif bu kapsama göre verilir.
- Tasarım ve prototip: Tıklanabilir bir prototiple kullanıcı yolculuğu baştan sona denenir.
- Geliştirme ve test: Geliştirme aşamalı ilerler; her aşama test ortamında denenip onaylanır.
- Yayın, veri aktarımı ve eğitim: Canlıya geçiş planlı bir zamanda yapılır; ilk günlerde kullanım yakından izlenir.
- Bakım ve destek: Hata bildirimleri kayıt altına alınır, güncellemeler test edilerek uygulanır.
Nothata kodu standardı.
07Örnek planlama hesabı
Örnek: günlük senkronizasyon isteği
- Ürün sayısı
- 5.500
- Günlük değişim oranı
- %6
- Kanal sayısı
- 6
- Günlük güncelleme isteği
- 1.980
- Saatlik ortalama
- 83
Oran sınırları platformca belirlenir; istekler kuyrukla güne dağıtılır. Not: örnek hesaptır; kesin plan analizde çıkar.
08Ç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.
- Alan adı ve sunucu hesapları işletme adına açılır.
- Kapsam ve teslim kriterleri yazılı olur.
- Yayın sonrası bakım ve destek planlanır.
Türkiye'nin 81 ilindeki işletmelerle uzaktan çalışıyoruz; İstanbul da bunlardan biri.
09Hangi durumlarda profesyonel destek gerekir?
Ö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.
- API yoğunlukta yavaşlıyor: kota ve önbellek yok, sorgular optimize değil.
- Kişisel veya finansal verinin işlendiği akışlar
- Birden fazla sistemle entegrasyon gerektiren işler
SSSSık sorulan sorular
Sonradan özellik ekleyebilir miyiz?
Evet; yazılım modüler planlanır, yeni özellikler sürüm planıyla eklenir.
Ö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.
Ö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 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.
Sadece İstanbul 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.
İstanbul'dan yazıyorum; toplantılar nasıl yapılıyor?
Toplantılar görüntülü yapılır ve ekran paylaşımıyla ilerler. Cihaz kurulumu, saha incelemesi veya ekip eğitimi gibi yerinde bulunmayı gerektiren adımlar ayrıca planlanır.
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.
→İlgili sayfalar
Özel API Servisi hakkında diğer konular
- Özel API servisi KOBİ'ler içinKüçük ve orta işletmeler için yol haritası
- Özel API servisi geçiş ve veri aktarımıExcel'den veya eski sistemden geçiş
- Özel API servisi entegrasyonlarıBağlanabilecek sistemler
- Ö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
İstanbul'da ilgili hizmetler
Marmara Bölgesi'ndeki diğer iller
İstanbul ilçelerinde özel API servisi yaptırma
- Adalar
- Arnavutköy
- Ataşehir
- Avcılar
- Bağcılar
- Bahçelievler
- Bakırköy
- Başakşehir
- Bayrampaşa
- Beşiktaş
- Beykoz
- Beylikdüzü
- Beyoğlu
- Büyükçekmece
- Çatalca
- Çekmeköy
- Esenler
- Esenyurt
- Eyüpsultan
- Fatih
- Gaziosmanpaşa
- Güngören
- Kadıköy
- Kağıthane
- Kartal
- Küçükçekmece
- Maltepe
- Pendik
- Sancaktepe
- Sarıyer
- Silivri
- Sultanbeyli
- Sultangazi
- Şile
- Şişli
- Tuzla
- Ümraniye
- Üsküdar
- Zeytinburnu
Bu sayfada geçen kavramlar
- sürümleme
- kota
- izleme
- SSO
- rate limit
- OpenAPI
- Swagger
- geliştirici portalı
- API anahtarı
- İstanbul