01Bağlanabilecek sistemler
- API ağ geçidi
- izleme ve log araçları
- nesne depolama
- kimlik sağlayıcılar
- e-posta/SMS/push sağlayıcıları
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.
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
- hata kodu standardı.
- oran sınırı ve kota
- 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 | anlık |
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.
07Hayrat için entegrasyon planı
Hayrat, Trabzon iline bağlı bir ilçedir ve PTT adres verisine göre 35 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; Hayrat'taki 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 Beşikdüzü, Tonya ve Vakfıkebir ilçeleri için de özel API servisi talepleri değerlendirilir; toplantılar uzaktan yapılır.
Hayrat bölgesinden özel API servisi için ilk görüşmeyi telefonla yapabiliriz: 0540 003 19 81. İsterseniz kısa bir not bırakın, biz arayalım.
SSSSık sorulan sorular
Hayrat'tan 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.
Trabzon 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.
Ö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.
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.
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.
Ö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 teknolojileriTeknoloji seçimi ve mimari
- Özel API servisi: hazır paket mi özel yazılım mı?Hazır çözüm ile özel geliştirmenin farkı
- Özel API servisi güvenlik ve KVKK uyumuYetki, yedek, log ve KVKK
- Özel API servisi yaptırmaKapsam, süreç ve iletişim
- Özel API servisi bakım ve destekYayın sonrası bakım, güncelleme ve destek
Hayrat'ta ilgili hizmetler
Trabzon içindeki diğer ilçeler
Bu sayfada geçen kavramlar
- sürümleme
- kota
- izleme
- SSO
- rate limit
- OpenAPI
- geliştirici portalı
- SDK
- Swagger
- Trabzon
- Hayrat