01Bağlanabilecek sistemler
- e-posta/SMS/push sağlayıcıları
- izleme ve log araçları
- nesne depolama
- kimlik sağlayıcılar
- API ağ geçidi
Trendyol, Hepsiburada, n11, Amazon Türkiye, Çiçeksepeti, Pazarama ve PttAVM gibi pazaryerlerinin satıcı panelleri ve API'leri, her platformun kendi kurallarıyla 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
- oran sınırı ve kota
- kimlik doğrulama (API anahtarı, OAuth 2.0)
- webhook imza doğrulaması
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 |
| Ödeme durumu | hedef → kaynak | anlık |
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.
07İlkadım için entegrasyon planı
İlkadım, Samsun iline bağlı bir ilçedir ve PTT adres verisine göre 62 mahalleden oluşur. Bu kayıtlardan 1 tanesi organize sanayi veya serbest bölge kaydıdır. 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: İlkadım'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.
Aynı ildeki Tekkeköy, Ladik ve Asarcık ilçeleri için de özel API servisi talepleri değerlendirilir; toplantılar uzaktan yapılır.
İlkadım 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
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.
İlkadım'da bulunuyorum, yerinde görüşme mümkün mü?
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.
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.
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.
Ö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.
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.
→İ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 geliştirme süreciAnalizden yayına aşamalar
- Özel API servisi yaptırmaKapsam, süreç ve iletişim
- Özel API servisi geçiş ve veri aktarımıExcel'den veya eski sistemden geçiş
- Özel API servisi: hazır paket mi özel yazılım mı?Hazır çözüm ile özel geliştirmenin farkı
İlkadım'da ilgili hizmetler
Samsun içindeki diğer ilçeler
Bu sayfada geçen kavramlar
- sürümleme
- kota
- izleme
- SSO
- rate limit
- OpenAPI
- webhook
- geliştirici portalı
- Swagger
- API anahtarı
- Samsun
- İlkadım