Mekante Geliştirici

Başlangıç

1. API anahtarı oluştur

API anahtarlarını yalnızca işletmenin sahibi oluşturabilir.

  1. İşletme panelinde Geliştiriciler sayfasını aç.
  2. Yeni API anahtarı'na bas, anahtara bir ad ver (örneğin Kasa entegrasyonu) ve anahtarın çalışacağı şubeyi seç.
  3. Anahtar oluştur'a bas. Anahtar sk_live_ ile başlar ve yalnızca bir kez gösterilir. Hemen güvenli bir yere kaydet. Kaybedersen yeni anahtar oluşturman gerekir.

Her anahtar tek bir şubeye bağlı, gizli bir kasiyer gibi çalışır. Bu yüzden POST /scan isteğinde şube göndermen gerekmez.

Anahtarı gizli tut

Anahtarı tarayıcıya, mobil uygulamaya ya da herkese açık bir depoya koyma. Yalnızca kasa yazılımının sunucu tarafında kullan. Sızdığını düşünüyorsan Geliştiriciler sayfasından iptal et.

2. İlk isteği gönder

Anahtarının çalıştığını GET /me ile dene:

curl https://app.mekante.com/api/v1/public/me \
  -H "Authorization: Bearer sk_live_ORNEK_ANAHTAR"

Yanıt, anahtarın bağlı olduğu işletmeyi ve şubeyi gösterir:

{
  "role": "cashier",
  "scopeLocationIds": null,
  "tenant": { "name": "Docs Cafe", "status": "trial", "joinCode": "8ET7P7H3" },
  "program": { "type": "points", "earnRate": 0.05, "expiryMonths": 12 },
  "locations": [{ "id": "…", "name": "…" }]
}

earnRate 1 TL başına kazanılan puandır; 1 puan 1 TL değerindedir, yani 0.05 yüzde 5 demektir. Yanıtta daha fazla alan vardır; yalnızca işine yarayanlar burada gösterildi. 401 alıyorsan Kimlik doğrulama sayfasına bak.

3. Sıradaki adım

Bir satışı puana çevirmek için Kasa akışı sayfasını oku.