Genel Bakış¶

MuditaKurye Nedir?¶

MuditaKurye, restoranlar ve kurye şirketleri için kurumsal düzeyde teslimat yönetim platformudur. Üçüncü taraf POS sistemleri, bu API aracılığıyla sipariş gönderimi yapabilir ve teslimat süreçlerini takip edebilir.

Temel Özellikler¶

🚀 Kolay Entegrasyon¶

REST API ile basit sipariş gönderimi
Webhook'lar ile gerçek zamanlı güncellemeler
API Key veya Basic Auth ile güvenli kimlik doğrulama

📦 Sipariş Yönetimi¶

Anında veya zamanlanmış teslimat desteği
Detaylı sipariş kalemleri ve modifikatörler
Müşteri bilgileri ve teslimat adresi yönetimi

🔔 Gerçek Zamanlı Bildirimler¶

Webhook'lar ile sipariş durum değişiklikleri
İptal bildirimleri
HMAC imza doğrulama (opsiyonel)

🗺️ Akıllı Rotalama¶

Otomatik kurye ataması (VRP optimizasyonu)
Geocoding desteği (enlem/boylam)
Çoklu teslimat noktası optimizasyonu

API Mimarisi¶

┌──────────────────┐
│   POS Sistemi    │
│  (Sizin sisteminiz)│
└────────┬─────────┘
         │ HTTPS
         │ POST /webhook/third-party/order
         ▼
┌──────────────────┐
│  MuditaKurye API │
│  (api.muditakurye│
│    .com.tr)      │
└────────┬─────────┘
         │
    ┌────┴────┐
    │         │
    ▼         ▼
┌─────────┐ ┌──────────┐
│ Restoran│ │  Kurye   │
│  Panel  │ │  Mobil   │
└─────────┘ └──────────┘

Desteklenen Senaryolar¶

Senaryo	Açıklama	Durum
Anında Teslimat	Sipariş onaylandıktan hemen sonra kurye ataması	✅ Destekleniyor
Zamanlanmış Teslimat	Belirli bir zamanda teslim edilmek üzere sipariş	✅ Destekleniyor
Ödeme Çeşitleri	Nakit, POS, Online ön ödeme	✅ Destekleniyor
Sipariş İptali	Restoran veya müşteri tarafından iptal	✅ Destekleniyor
Multi-tenant	Birden fazla restoran/marka yönetimi	✅ Destekleniyor

Entegrasyon Adımları¶

Kayıt ve Kimlik Bilgileri
MuditaKurye ile iletişime geçin
Restoran hesabı oluşturun
API kimlik bilgilerini alın
Test Ortamında Geliştirme
Staging URL'ini kullanın
Örnek istekler gönderin
Webhook endpoint'inizi test edin
Canlıya Geçiş
Production kimlik bilgilerini alın
DNS ve webhook URL'lerini güncelleyin
İzleme ve loglama ekleyin
İzleme ve Optimizasyon
API yanıt sürelerini takip edin
Hata oranlarını izleyin
Webhook teslim başarısını kontrol edin

Sınırlamalar ve Kısıtlamalar¶

Kısıt	Değer
Rate Limit	100 istek/dakika (API Key başına)
Max Request Size	1 MB
Max Order Items	100 adet
Webhook Timeout	5 saniye
Webhook Retry	24 saat (exponential backoff)

Rate Limit Artırımı

Daha yüksek rate limit ihtiyacınız varsa info@muditayazilim.com.tr ile iletişime geçin.

SLA Garantileri¶

API Uptime: %99.9
Webhook Delivery: %99.5
Yanıt Süresi (P95): < 500ms
Destek Yanıt Süresi: < 2 saat (çalışma saatleri)

Sonraki Adım¶

Entegrasyona başlamak için Kimlik Doğrulama sayfasına geçin.