API & Integrations

14. API & Integrations

[skrinshot: 0601_Apikey.png]

API & Integrations bo‘limida 7stampni tashqi tizimlaringiz — CRM, POS, ERP, analitika, messenjer botlari bilan dasturiy integratsiyalash vositalari mavjud.

API kalitlari

Bo’limning asosiy sahifasi - API kalitlar ro’yxati. Ustunlar:

• Ism — kalit nomi (odatda bog‘langan Staff nomiga mos keladi).
• Login — kalit ulangan Staff login.
• API Kaliti — kalitning o‘zi (7loc_sc_... bilan boshlanadi, sukut bo‘yicha yashiriladi, bir marta bosish bilan nusxalanadi).
• Holat — Active.
• 🔄 — kalitni qayta tiklash.
• 🗑️ — kalitni oʻchirish.

API kalitini yaratish

[skrinshot: 0602_Apikey.png]

+ API kalitini qo‘shish-ga teging — API kalitini yaratish qalqib chiquvchi oynasi ochiladi:

• Scanner — Staffni tanlash uchun ochiladigan ro‘yxat. Kirish kaliti bog‘lanadi (bitta Staff bitta kalitga ega bo‘lishi mumkin).
• CANCEL / GENERATE tugmalari.

GENERATE dan so’ng kalit yaratiladi va ro’yxatda paydo bo’ladi. Uni darhol nusxalash — toʻliq kalit boshqa koʻrsatilmasligi mumkin.

API orqali nima qilishingiz mumkin

• Kartani e-pochta/telefon orqali mijozga berish.
• Muayyan mijozga shtamp qo’shing.
• Vucher berish (shablonli yoki maxsus, Redeem Code bilan).
• Vucherni sotib oling (agar siz o’zingizning POS orqali ishlasangiz).
• Kartani o’qish holati, taraqqiyot, tarix.
• Vebhooks-ga obuna bo’ling voqealarni real vaqtda qabul qilish.

Vebhuklar

Webhooks karta hodisalarini tashqi tizimga yuboradi. Qo’llab-quvvatlanadi (voqea lug’atiga qarang):

• voucher_issued, voucher_redeemed, voucher_expired.
• lottery_played (natija bilan).
• card_issued, card_saved, card_opened.
• birthday_reached.
• stamp_added.
• inactivity_trigger.
• goal_reached, reward_issued.
• campaign_sent.

Webhook yuklash misoli

{
  "event": "voucher_redeemed",
  "timestamp": "2026-05-11T12:34:56Z",
  "business_id": "b_123",
  "location_id": "loc_45",
  "customer": {
    "id": "c_789",
    "wallet_pass_id": "wp_abc",
    "language": "en"
  },
  "card": { "id": "card_001", "goal_index": 2 },
  "voucher": {
    "id": "v_555",
    "type": "voucher",
    "redeem_code": "FREECOFFEE",
    "redeem_code_formats": ["text", "qr", "barcode"],
    "status": "redeemed",
    "redeemed_via": "staff_scanner"
  }
}

Tayyor POS integratsiyalari

• Poster — tayyor integratsiya, bir necha marta bosish orqali ulanadi.
• Serve — tayyor integratsiya.
• Boshqa to’lovlar — so’rov bo’yicha amalga oshiriladi. Texnik jihatdan imkoni bo’lsa, bepul (ya’ni, sizning tillingiz ochiq API yoki Webhooksni ko’rsatsa).

Messenger 7loc.com orqali uzatiladi

WhatsApp, Telegram, Viber translyatsiyalari uchun 7loc.com integratsiyasi ulangan. Faollashgandan so’ng, “messenjerlar” kanali PUSH va Email yonida Campaigns da mavjud bo’ladi.

Kodsiz stsenariylar: Zapier va Make

7stamp API + Webhooks Zapier va Make (Integromat) bilan ishlaydi, bu sizga kodlashsiz stsenariylarni yaratish imkonini beradi:

• “birthday_reached qachon — CRM da vazifa yaratish”.- “voucher_redeemed bo’lganda — Mailchimp’ga teg qo’shing”.
• “goal_reached qachon — Slack-ga bildirishnoma yuboring”.

---