Limitler

İstek sınırı

Her API anahtarı dakikada 120 istek yapabilir. Aşarsan 429 alırsın:

{ "error": "Too Many Requests", "code": "RATE_LIMITED", "message": "Too many requests. Slow down." }

Bir dakika bekle ve tekrar dene. Bunun yanında tüm /api istekleri için IP başına dakikada 1200 istek gibi geniş bir üst sınır da vardır; normal bir kasa yazılımı buna takılmaz.

İstek gövdesi

Bir istek en fazla 1 MB olabilir. Daha büyüğü 413 PAYLOAD_TOO_LARGE döner. Kasa istekleri bunun çok altındadır.

İşletmenin program ayarları

Aşağıdakiler işletme sahibinin Program kuralları sayfasında belirlediği sınırlardır. Aşıldığında ilgili hata dönülür. Varsayılan değerler yeni bir işletmede şöyledir:

Ayar	Varsayılan	Aşılırsa
Tek satışta en yüksek tutar	5.000 TL (`500000` kuruş)	`422 AMOUNT_TOO_HIGH`
Bir müşteri günde en fazla	5 puan kazanımı	`429 DAILY_EARN_LIMIT`
Bir kasiyer (anahtar) günde en fazla	500 puan kazanımı	`429 CASHIER_DAILY_LIMIT`
Tek işlemde en çok puan	1000	yazılacak puan bu değerle sınırlanır (hata dönmez)
Tek ziyarette en çok damga	10	`422 TOO_MANY_STAMPS`

Günlük sayımlar Türkiye saatiyle gece yarısı sıfırlanır. Bu değerleri kendi işletmenin ayarlarından GET /me yanıtındaki program alanında görebilirsin.

Büyük satış uyarısı

İşletme, belirli bir tutarın üstündeki satışlar için uyarı tanımlayabilir. Bu satışlar reddedilmez; yalnızca işletmenin raporlarında işaretlenir.

Deneme süresi dolan ya da askıya alınan işletmelerde POST /scan 402 döner (TRIAL_EXPIRED, SUBSCRIPTION_SUSPENDED). Okutma yapılamadığı için puan yazma ve ödül düşme de başlamaz. Sahibinin Mekante destek ekibiyle iletişime geçmesi gerekir.

QR ve okutma süreleri

Ne	Süre
QR kodun ömrü	30 saniye
Okutma sonrası puan yazma / ödül düşme	5 dakika
Girişi geri alma (anahtar için)	15 dakika