Kampanyalar

Kampanya oluştur

POST
/v1/kampanyalar

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.

Başlık parametreleri

Idempotency-Key?string

Aynı anahtar ve aynı istek 24 saat içinde tekrar gelirse iş yeniden yapılmaz, ilk yanıt döner. Ağ hatasında güvenle yeniden denemek için.

Uzunluklength <= 255

İstek gövdesi

application/json
  1. body
ad*string
Uzunluk1 <= length <= 200
tur*string
Değerlerden biri"indirim""x_al_y_ode""kargo_bedava""ikinciye_indirim"
kod?|

Büyük harf, rakam, - ve _. Boş/null: kodsuz, sepete kendiliğinden uygulanır

indirim_tipi?string
Varsayılan"yuzde"
Değerlerden biri"yuzde""tutar"
deger?integer

indirim: yüzde (1–100) ya da kuruş; ikinciye_indirim: yüzde

Aralık0 <= value
Varsayılan0
al?integer|null
ode?integer|null
kapsam?string
Varsayılan"tumu"
Değerlerden biri"tumu""urunler""kategoriler"
hedefler?array<string>

Kapsam ürün ya da kategoriyse kimlikleri

Ögeleritems <= 500
min_sepet?|null
baslangic?string|null
bitis?string|null
kullanim_siniri?|null
musteri_eposta?|null
aktif?boolean
Varsayılantrue

Yanıt gövdesi

Oluşturuldu

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 POST 'https://api.multikolay.com/v1/kampanyalar' \  -H 'Content-Type: application/json' \  -d '{  "ad": "string",  "tur": "indirim"}'
Örnek yanıt
{  "id": "string",  "ad": "string",  "tur": "indirim",  "kod": "string",  "otomatik": true,  "aktif": true,  "indirim_tipi": "yuzde",  "deger": 0,  "al": 0,  "ode": 0,  "kapsam": "tumu",  "hedefler": [    "string"  ],  "min_sepet": 0,  "para_birimi": "string",  "musteri_eposta": "string",  "kullanim_siniri": 0,  "kullanim": 0,  "toplam_indirim": 0,  "baslangic": "string",  "bitis": "string",  "olusturma": "string",  "guncelleme": "string"}