Kampanyalar

Kampanyayı getir

GET
/v1/kampanyalar/{id}

Kimlik doğrulama

anahtar
headerKimlik doğrulamaBearer <anahtar>

Panel → Ayarlar → API anahtarları (mk_canli_…). Denemek için paylaşılan test mağazası: mk_test_… anahtarları yalnız orada; herkese açık deneme anahtarı silme yapamaz, IP başına dakikada 60 istek; mağaza her gece 03.00'te (TSİ) baştan kurulur.

Yol parametreleri

id*string

Yanıt gövdesi

Başarılı

application/json
  1. response
id*string
ad*string
tur*string
Değerlerden biri"indirim""x_al_y_ode""kargo_bedava""ikinciye_indirim"
kod*string

İndirim kodu (otomatik kampanyada iç kod)

otomatik*boolean

Kod girilmeden sepete uygulanır

aktif*boolean
indirim_tipi*string
Değerlerden biri"yuzde""tutar"
deger*integer

Yüzde (ör. 15) ya da kuruş tutar

al*|

x_al_y_ode: kaç alınca

ode*|

x_al_y_ode: kaç ödenir

kapsam*string
Değerlerden biri"tumu""urunler""kategoriler"
hedefler*array<string>

Kapsam ürün ya da kategoriyse kimlikleri

min_sepet*|null
para_birimi*string
musteri_eposta*|

Yalnız bu müşteriye özel kod

kullanim_siniri*integer|null
kullanim*integer
toplam_indirim*integer

Kuruş, KDV dahil (184990 = 1.849,90 ₺)

baslangic*|null
bitis*|null
olusturma*string

ISO 8601, UTC

guncelleme*string

ISO 8601, UTC

Örnek istek
curl -X GET 'https://api.multikolay.com/v1/kampanyalar/string'
Örnek yanıt
{  "id": "kamp_01M599DXNFFV3HCWEHEAEXW70T",  "ad": "1.500 TL üzeri kargo bedava",  "tur": "kargo_bedava",  "kod": "OTO-M6UL5T",  "otomatik": true,  "aktif": true,  "indirim_tipi": "yuzde",  "deger": 100,  "al": null,  "ode": null,  "kapsam": "tumu",  "hedefler": [],  "min_sepet": null,  "para_birimi": "TRY",  "musteri_eposta": null,  "kullanim_siniri": null,  "kullanim": 0,  "toplam_indirim": 0,  "baslangic": null,  "bitis": null,  "olusturma": "2026-10-19T05:16:27.693Z",  "guncelleme": "2026-10-19T05:16:27.693Z"}