01Bağlanabilecek sistemler
- izleme ve log araçları
- API ağ geçidi
- kimlik sağlayıcılar
- nesne depolama
- e-posta/SMS/push sağlayıcıları
Google Search Console, Google Analytics 4, Google Tag Manager, Google İşletme Profili, Bing Webmaster Tools ve IndexNow ölçüm ve arama görünürlüğü için temel araçlardır.
WhatsApp Business Platformu (Meta), SMS sağlayıcıları (İYS onayıyla) ve e-posta servisleri bildirim ve müşteri iletişiminde kullanılır.
02Entegrasyon yöntemleri
API
Sistemin resmî programlama arayüzü üzerinden veri alışverişi; en güvenilir ve izlenebilir yöntemdir.
Webhook
Bir olay olduğunda karşı sistemin anında haberdar edilmesi; sürekli sorgulama ihtiyacını azaltır.
Dosya aktarımı
CSV veya XML dosyalarının zamanlanmış olarak alınıp verilmesi; API olmayan sistemlerde kullanılır.
Veritabanı bağlantısı
Yalnız ürün sağlayıcısının izin verdiği durumlarda, okuma ağırlıklı ve dikkatli kullanılır.
03Özel API servisi planlarken bilinmesi gerekenler
- OpenAPI dokümantasyonu
- webhook imza doğrulaması
- kimlik doğrulama (API anahtarı, OAuth 2.0)
04Örnek veri akışı
| Veri | Yön | Sıklık |
|---|---|---|
| Müşteri / cari kartı | çift yönlü | değişiklikte |
| Sipariş veya kayıt | özel API servisi → muhasebe | oluştuğunda |
| Fatura / belge | muhasebe → e-belge | onaylandığında |
| Bildirim | kaynak → hedef | zamanlanmış |
05Hata yönetimi
Her entegrasyonda başarısız aktarımlar bir hata kuyruğunda tutulur, yeniden denenir ve raporlanır; hiçbir kayıt sessizce kaybolmaz.
06İlgili entegrasyon sayfaları
İlgili hizmetler: API yönetim paneli ve geliştirici portalı, webhook servisi, kimlik doğrulama ve SSO ve otomatik fatura okuma. Entegrasyon ayrıntıları için aşağıdaki bağlantıları inceleyebilirsiniz.
07Köşk için entegrasyon planı
Köşk, Aydın iline bağlı bir ilçedir ve PTT adres verisine göre 28 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.
Mesafe yazılım işinin önünde engel değildir: Köşk'teki 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.
Aydın genelinde Kuşadası, Didim ve Aydın Yenipazar gibi diğer ilçelerdeki işletmelerle de aynı uzaktan çalışma düzeniyle ilerlenir.
Mevcut Excel dosyanızı veya ekran görüntülerinizi WhatsApp'tan gönderin; özel API servisi için hangi modüllerle başlanabileceğini konuşalım. Telefon: 0540 003 19 81.
SSSSık sorulan sorular
Ö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.
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.
Her programla entegrasyon yapılabilir mi?
Programın resmî bir API, dosya aktarımı veya entegrasyon aracı sunması gerekir; analizde hangi yöntemin kullanılabileceği kontrol edilir.
Entegrasyon için ek lisans gerekir mi?
Bazı ürünler entegrasyon için ek modül veya kullanıcı lisansı isteyebilir; bu ürün sağlayıcısının güncel koşullarına bağlıdır.
Entegrasyon için mevcut programımızı değiştirmemiz gerekir mi?
Genellikle hayır. Mevcut programın resmî entegrasyon araçları kullanılır; bazı yöntemler ek modül veya lisans gerektirebilir, bu analizde netleşir.
Sadece Aydın için mi çalışıyorsunuz?
Hayır, Türkiye'nin her ilindeki işletmelerle çalışıyoruz; Ege Bölgesi dahil tüm bölgelerde süreç aynı düzenle yürü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.
Köşk'ten yazıyorum; toplantılar nasıl yapılıyor?
İş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.
→İlgili sayfalar
Özel API Servisi hakkında diğer konular
- Özel API servisi güvenlik ve KVKK uyumuYetki, yedek, log ve KVKK
- Özel API servisi: hazır paket mi özel yazılım mı?Hazır çözüm ile özel geliştirmenin farkı
- Özel API servisi fiyatlarıMaliyeti belirleyen kalemler ve teklif karşılaştırma
- Özel API servisi geçiş ve veri aktarımıExcel'den veya eski sistemden geçiş
- Özel API servisi geliştirme süreciAnalizden yayına aşamalar
Köşk'te ilgili hizmetler
Aydın içindeki diğer ilçeler
Bu sayfada geçen kavramlar
- sürümleme
- kota
- izleme
- SSO
- rate limit
- OpenAPI
- Swagger
- API anahtarı
- Aydın
- Köşk