Entegrasyon Ekleme ve Yönetme¶

MuditaPOS API'sini kullanarak, kurye sistemi panelinize (müşteri tarafı) bağlı olan restoranların Yemeksepeti, Getir, Trendyol vb. platform bilgilerini dışarıdan, programatik olarak ekleyebilirsiniz.

Böylece restoran kendi API bilgilerini size sağladığında, manuel işlem yapmadan doğrudan MuditaPOS'a kendi sisteminiz üzerinden aktarabilirsiniz.

Kimlik Doğrulama (Auth)¶

Tüm istekler X-API-Key ve X-API-Secret başlıklarını (header) gerektirir.

Bu bilgileri MuditaPOS SuperAdmin'inden veya MuditaPOS panelinizden öğrenebilirsiniz.

X-API-Key: sizin-api-keyiniz
X-API-Secret: sizin-api-secret-keyiniz
Content-Type: application/json

1. Yeni Entegrasyon Ekleme¶

Yeni bir platform entegrasyonu eklemek için kullanılır. Platform tiplerine göre gönderilmesi gereken JSON gövdesi değişmektedir.

Endpoint: POST /api/v1/my/integrations

Örnek İstek (Getir)¶

curl -X POST https://stage.pos.muditakurye.com.tr/api/v1/my/integrations \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "GETIR",
    "providerRestaurantId": "getir-rest-123",
    "secretKey": "getir-secret-abc",
    "isActive": true
  }'

Örnek İstek (Yemeksepeti)¶

{
  "platform": "YEMEKSEPETI",
  "providerRestaurantId": "ys-vendor-456",
  "chainCode": "ys-chain",
  "username": "ys-user",
  "password": "ys-pass",
  "isActive": true
}

Örnek İstek (Trendyol)¶

{
  "platform": "TRENDYOL_GO",
  "providerRestaurantId": "trendyol-789",
  "supplierId": "789",
  "apiKey": "trendyol-api-key",
  "secretKey": "trendyol-secret",
  "storeId": "store-1",
  "isActive": true
}

Örnek İstek (Migros Yemek)¶

{
  "platform": "MIGROS_YEMEK",
  "providerRestaurantId": "migros-store-101",
  "providerMerchantId": "101",
  "apiKey": "migros-x-api-key",
  "isActive": true
}

2. Entegrasyonları Listeleme¶

Mevcut tüm entegrasyonlarınızı listelemek için kullanılır.

Endpoint: GET /api/v1/my/integrations

Örnek İstek¶

curl -X GET https://stage.pos.muditakurye.com.tr/api/v1/my/integrations \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET"

3. Entegrasyon Detayı Getirme¶

Belirli bir entegrasyonun ID'sini vererek detaylarını görüntüleyebilirsiniz.

Endpoint: GET /api/v1/my/integrations/:id

4. Entegrasyon Güncelleme¶

Bir entegrasyonun şifresi veya API Key'i değiştiğinde güncellemek için kullanılır. Sadece değişen alanları gönderebilirsiniz.

Endpoint: PUT /api/v1/my/integrations/:id

Örnek İstek (Sadece şifre güncelleme)¶

{
  "password": "ys-new-password"
}

5. Entegrasyon Durumu Değiştirme¶

Sipariş alımını geçici olarak durdurmak veya yeniden başlatmak için isActive bayrağını kullanabilirsiniz.

Aktifleştirme Endpoint: PATCH /api/v1/my/integrations/:id/activate
Devre Dışı Bırakma Endpoint: PATCH /api/v1/my/integrations/:id/deactivate

6. Entegrasyon Silme¶

Artık kullanılmayacak bir entegrasyonu tamamen kaldırmak için kullanılır.

Endpoint: DELETE /api/v1/my/integrations/:id