Geliştiriciler
multikolay.com
BaşlangıçTema geliştirmeAPI referansıWebhook'larDeğişiklikler
Siparişler

Siparişleri listele

GET
/v1/siparisler

Siparişleri en yeniden eskiye döner. Durum paneldekiyle aynı: ödeme bekliyor (havale), hazırlanıyor, kargoda, teslim edildi, iptal, iade.

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.

Sorgu parametreleri

limit?integer

Bir sayfadaki kayıt sayısı (1–100)

Aralık1 <= value <= 100
Varsayılan20
sonraki?string

Önceki yanıttaki sonraki değeri; boşsa ilk sayfa

Uzunluklength <= 200
durum?string
Değerlerden biri"odeme_bekliyor""hazirlaniyor""kargoda""teslim_edildi""iptal""iade"
eposta?string

Müşteri e-postası (tam eşleşme, büyük/küçük harf duyarsız)

Uzunluklength <= 200
olusturma_sonra?string
olusturma_once?string
guncelleme_sonra?string

Bu andan sonra değişen siparişler (eşitleme için)

Yanıt gövdesi

Başarılı

application/json
  1. response
veri*array<>
sonraki*|

Sonraki sayfanın imleci; son sayfada null

Örnek istek
curl -X GET 'https://api.multikolay.com/v1/siparisler'
Örnek yanıt
{  "veri": [    {      "id": "order_01M599DZVJ4NA749A5MQ6MZX9B",      "no": "6",      "durum": "hazirlaniyor",      "para_birimi": "TRY",      "urun_toplam": 220000,      "indirim_toplam": 0,      "kargo_toplam": 0,      "toplam": 220000,      "odenen": 0,      "iade_edilen": 0,      "indirim_kodlari": [],      "musteri": {        "id": "cus_01M599DXK4PDTHJSDG9ERXCR19",        "eposta": "[email protected]"      },      "teslimat_adresi": {        "ad": "Selin",        "soyad": "Öztürk",        "sirket": null,        "telefon": "5320000007",        "satir1": "Örnek Mah. Deneme Sok. No: 1",        "satir2": null,        "ilce": "Tepebaşı",        "il": "Eskişehir",        "posta_kodu": null,        "ulke": "tr",        "fatura_tipi": null,        "tckn": null,        "vergi_no": null,        "vergi_dairesi": null      },      "fatura_adresi": null,      "kalemler": [        {          "id": "ordli_01M599DZVRNWQACVGZQHGGZ8SF",          "urun_id": "prod_01M599DWJH0Q1JXKR1QQ3WY91E",          "varyant_id": "variant_01M599DWJYBK7NJ2W0R5ZQT9GB",          "ad": "Hasır Sepet",          "varyant_ad": "Hasır Sepet",          "sku": "GLS-SEPET",          "adet": 1,          "birim_fiyat": 64000,          "indirim": 0,          "toplam": 64000,          "kdv_orani": 20,          "gonderilen": 0,          "teslim_edilen": 0,          "iade_edilen": 0        },        {          "id": "ordli_01M599DZVRF2W1H5M8XVWFFQ60",          "urun_id": "prod_01M599DVWDF85148P6NX3NY5Y0",          "varyant_id": "variant_01M599DVYZ4D3R4V2EZBCHSNH3",          "ad": "Ege Seramik Kupa",          "varyant_ad": "Lacivert",          "sku": "GLS-KUPA-LACI",          "adet": 4,          "birim_fiyat": 39000,          "indirim": 0,          "toplam": 156000,          "kdv_orani": 20,          "gonderilen": 0,          "teslim_edilen": 0,          "iade_edilen": 0        }      ],      "odemeler": [        {          "id": "pay_01M599DZVVA9SYXFBGD8X2YQN3",          "yontem": "diger",          "saglayici": "pp_system_default",          "durum": "yetkilendi",          "tutar": 220000,          "olusturma": "2026-10-19T05:16:29.894Z"        }      ],      "gonderiler": [],      "kaynak": "vitrin",      "iptal": null,      "olusturma": "2026-10-19T05:16:29.894Z",      "guncelleme": "2026-10-19T05:16:29.894Z"    },    {      "id": "order_01M599DZK4Z4FFPBDT15NPP629",      "no": "5",      "durum": "hazirlaniyor",      "para_birimi": "TRY",      "urun_toplam": 134000,      "indirim_toplam": 0,      "kargo_toplam": 0,      "toplam": 134000,      "odenen": 0,      "iade_edilen": 0,      "indirim_kodlari": [],      "musteri": {        "id": "cus_01M599DXHYHSK498JR2ZTBD77A",        "eposta": "[email protected]"      },      "teslimat_adresi": {        "ad": "Elif",        "soyad": "Şahin",        "sirket": null,        "telefon": "5320000005",        "satir1": "Örnek Mah. Deneme Sok. No: 1",        "satir2": null,        "ilce": "Muratpaşa",        "il": "Antalya",        "posta_kodu": null,        "ulke": "tr",        "fatura_tipi": null,        "tckn": null,        "vergi_no": null,        "vergi_dairesi": null      },      "fatura_adresi": null,      "kalemler": [        {          "id": "ordli_01M599DZK7W8HC9NXNBRCSFY6D",          "urun_id": "prod_01M599DWE17C3FG9HPV9150TBF",          "varyant_id": "variant_01M599DWEQRQHB8J55SXZPPWQQ",          "ad": "Kum Seramik Vazo",          "varyant_ad": "Kum Seramik Vazo",          "sku": "GLS-VAZO",          "adet": 1,          "birim_fiyat": 89000,          "indirim": 0,          "toplam": 89000,          "kdv_orani": 20,          "gonderilen": 0,          "teslim_edilen": 0,          "iade_edilen": 0        },        {          "id": "ordli_01M599DZK7SEZDHZKP86X8A0CE",          "urun_id": "prod_01M599DW8Y5SZD3PMNB2E8MBMA",          "varyant_id": "variant_01M599DW9N9M399ZJSWKGHJBFM",          "ad": "Cam Sürahi",          "varyant_ad": "Cam Sürahi",          "sku": "GLS-SURAHI",          "adet": 1,          "birim_fiyat": 45000,          "indirim": 0,          "toplam": 45000,          "kdv_orani": 20,          "gonderilen": 0,          "teslim_edilen": 0,          "iade_edilen": 0        }      ],      "odemeler": [        {          "id": "pay_01M599DZK9JHECB86YM611DMK3",          "yontem": "diger",          "saglayici": "pp_system_default",          "durum": "yetkilendi",          "tutar": 134000,          "olusturma": "2026-10-19T05:16:29.643Z"        }      ],      "gonderiler": [],      "kaynak": "vitrin",      "iptal": null,      "olusturma": "2026-10-19T05:16:29.643Z",      "guncelleme": "2026-10-19T05:16:29.643Z"    }  ],  "sonraki": "WyJvcmRlcl8wMU01OTlEWks0WjRGRlBCRFQxNU5QUDYyOSJd"}

Listeye fiyat yaz POST

Önceki

Siparişi getir GET

Sonraki