01Bağlanabilecek sistemler
- kimlik sağlayıcılar
- API ağ geçidi
- izleme ve log araçları
- nesne depolama
- e-posta/SMS/push sağlayıcıları
Ödeme için bankaların sanal POS'ları veya iyzico, PayTR, Param gibi lisanslı ödeme kuruluşları kullanılır.
Yurtiçi Kargo, Aras Kargo, MNG Kargo, PTT Kargo, Sürat Kargo, HepsiJet ve Trendyol Express gibi firmalar gönderi oluşturma ve takip servisleri sunar.
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
- webhook imza doğrulaması
- OpenAPI dokümantasyonu
- 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 | hedef → kaynak | zamanlanmış |
05Hata yönetimi
Entegrasyonun en önemli parçası hata anında ne olacağıdır: kayıt bekletilir, yeniden denenir ve sorumlu kişiye bildirim gider.
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.
07Hangi durumlarda gündeme gelir?
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.
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.
08Sorgun için entegrasyon planı
Sorgun, Yozgat iline bağlı bir ilçedir ve PTT adres verisine göre 120 mahalle ve köy kaydından oluşur.
Sorgun'da bulunan bir işletmeyle çalışırken toplantılar görüntülü yapılır, her aşama test ortamında paylaşılır ve geri bildirimler ortak panoda toplanır; yerinde bulunmak gereken kurulum ve eğitim adımları ayrıca planlanır.
Yozgat genelinde Akdağmadeni, Yozgat Merkez ve Yerköy 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
Yozgat dışındaki işletmelere de hizmet veriyor musunuz?
Evet. Askadar Yazılım, Türkiye'nin 81 ilindeki işletmelerle uzaktan çalışır; gerektiğinde yerinde çalışma ayrıca planlanır.
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.
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 bozulursa ne olur?
İzleme ve uyarı sayesinde hata fark edilir; bekleyen kayıtlar sorun giderildikten sonra kaldığı yerden aktarılı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.
Ö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.
→İlgili sayfalar
Özel API Servisi hakkında diğer konular
- Özel API servisi bakım ve destekYayın sonrası bakım, güncelleme ve destek
- Ö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
- Özel API servisi fiyatlarıMaliyeti belirleyen kalemler ve teklif karşılaştırma
- Özel API servisi: hazır paket mi özel yazılım mı?Hazır çözüm ile özel geliştirmenin farkı
Sorgun'da ilgili hizmetler
Yozgat içindeki diğer ilçeler
Bu sayfada geçen kavramlar
- sürümleme
- kota
- izleme
- SSO
- rate limit
- OpenAPI
- geliştirici portalı
- Swagger
- SDK
- Yozgat
- Sorgun