MuditaKurye Third-Party Integration API¶
MuditaKurye platformuna harici sistemlerden sipariş gönderimi ve durum bildirimleri için API dokümantasyonuna hoş geldiniz.
Hızlı Başlangıç¶
Bu dokümantasyon, POS entegratörlerinin MuditaKurye platformu ile nasıl entegre olacağını açıklar:
- Sipariş Gönderimi: REST API üzerinden yeni siparişler oluşturun
- Durum Güncellemeleri: Webhook'lar aracılığıyla gerçek zamanlı sipariş durumu bildirimleri alın
- Kimlik Doğrulama: API Key veya Basic Auth ile güvenli erişim
API Base URL¶
| Ortam | URL |
|---|---|
| Production | https://api.muditakurye.com.tr |
| Staging | https://staging-api.muditakurye.com |
HTTPS Zorunludur
Tüm istekler HTTPS üzerinden yapılmalıdır. HTTP bağlantıları desteklenmez.
Kimlik Bilgilerinizi Nasıl Alırsınız?¶
- MuditaKurye restoran yönetim paneline giriş yapın
- Restoran ayarlarına gidin
- "Entegrasyon" sekmesini açın
- API Key veya kullanıcı adı/şifre oluşturun
Önemli Güvenlik Notu
Kimlik bilgileri sadece bir kez gösterilir ve tekrar alınamaz. Güvenli bir yerde saklayın.
Temel Entegrasyon Akışı¶
sequenceDiagram
participant POS as POS Sistemi
participant API as MuditaKurye API
participant Rest as Restoran
participant Courier as Kurye
POS->>API: POST /webhook/third-party/order
API-->>POS: 202 Accepted
API->>Rest: Sipariş bildirimi
Rest->>API: Sipariş onayı
API->>POS: Webhook: status=VALIDATED
API->>Courier: Kurye ataması
Courier->>API: Kabul
API->>POS: Webhook: status=ASSIGNED
Rest->>API: Hazır
API->>POS: Webhook: status=PREPARED
Courier->>API: Teslim alındı
API->>POS: Webhook: status=ON_DELIVERY
Courier->>API: Teslim edildi
API->>POS: Webhook: status=DELIVERED
Sonraki Adımlar¶
- Kimlik Doğrulama - API'ye güvenli erişim
- Sipariş Oluşturma - İlk siparişinizi gönderin
- Webhook'lar - Durum güncellemelerini alın
- Örnekler - Hazır kod örnekleri
Destek¶
Entegrasyon desteği için:
- E-posta: info@muditayazilim.com.tr
- Telefon: +90 553 205 55 67
- Dokümantasyon: https://docs.muditakurye.com