Zion Tools API va vebxuklari: sayt va CRMni Telegramga ulash

Zion Tools API va vebxuklari: sayt va CRMni Telegramga ulaymiz

«Sozlamalar»dagi Vebxuklar va API varagʻi Zion Toolsni servislaringiz bilan bogʻlaydi: sayt, CRM, TradingView, Zapier, Make yoki oʻz skriptingiz. Bu yerda ikkita vosita bor, ikkalasi ham har qanday tarifda bepul.

API kaliti — dasturlaringiz kabinet maʼlumotlarini oʻzi oʻqiydi: balans, akkauntlar, yoʻnalishlar, «Buxgalteriya» yozuvlari, modullar jurnallari. Yozish huquqli kalit bundan tashqari akkauntlardan xabar yuboradi va yozuv qoʻshadi.
Kiruvchi vebxuk — servisingiz hodisa yuboradigan manzil. Zion darhol amalni bajaradi: Telegramga xabar yozadi yoki «Buxgalteriya»ga yozuv qoʻshadi.

1-qadam. API kalitini chiqaring

Sozlamalar → Vebxuklar va API varagʻini oching va Kalit yaratish tugmasini bosing. Kalitga nom bering (masalan, «CRM») va ruxsatni tanlang:

Faqat oʻqish — balans, akkauntlar, yoʻnalishlar va modullar jurnallari;
Oʻqish va yozish — bunga qoʻshimcha akkauntlardan xabarlar, «Buxgalteriya» yozuvlari va AML tekshiruvi.

Kalit kabinet paroli bilan tasdiqlanib chiqariladi (Google Authenticator yoqilgan boʻlsa, uning kodi ham soʻraladi): kalit siz uni oʻchirmaguningizcha ishlaydi, kabinetdan chiqish uni bekor qilmaydi. Kalit faqat bir marta koʻrsatiladi: undan nusxa oling va dasturingiz sozlamalarida saqlang. Yoʻqotib qoʻysangiz, kalitni oʻchiring va yangisini yarating.

2-qadam. Birinchi soʻrovni yuboring

API manzili — https://zion.tools/api/v1, kalit Authorization: Bearer sarlavhasida uzatiladi, undan keyin kalitingiz yoziladi. Birinchi soʻrov — GET /api/v1/me: javobda profil, balans va tarif keladi. Javoblar — JSON, summalar — ikki kasr xonali satr, vaqt — Unix vaqti.

Metodlarning toʻliq roʻyxati «Qanday ulanish» blokidagi Barcha metodlar tugmasi ortida: akkauntlar va ularning chatlari, uzatish yoʻnalishlari, «Buxgalteriya» yozuvlari va kategoriyalari, cheklar, «Alertlar» va «Validator» jurnallari, «Analitika» operatsiyalari, balans tarixi. Uzun roʻyxatlar sahifalab beriladi: limit va before parametrlari.

API orqali pul toʻldirish yoki yechib olish, steykingga qoʻyish yoki tarifni almashtirish mumkin emas — bular faqat kabinetda. Pullik amallar (AML tekshiruvi) kabinetdagi bilan bir xil narxda. Bitta kalitga daqiqasiga 120 tadan ortiq soʻrov yuborib boʻlmaydi.

3-qadam. Kiruvchi vebxuk yarating

Kiruvchi vebxuklar blokida Vebxuk yaratish tugmasini bosing, nom bering va soʻrov bilan nima qilishni tanlang:

Akkauntdan xabar — Telegram akkauntingizning istalgan chatiga: akkaunt va chatni tanlang;
Bot orqali xabar — «Alertlar» boti «Alertlar» boʻlimida unga ulangan chatga yozadi;
«Buxgalteriya»ga yozuv — amount maydonidagi summa tanlangan kategoriyaga tushadi.

Saqlagandan keyin vebxuk manzilidan avtomatik nusxa olinadi — uni servisingiz sozlamalariga qoʻying. Manzil sir saqlanishi kerak: uni bilgan har kim soʻrov yubora oladi. Agar u begona qoʻlga tushsa, «Yangi manzil» tugmasini bosing — avvalgisi darhol ishlamay qoladi.

4-qadam. Xabar matnini sozlang

Vebxuk JSON, forma yoki oddiy matnni qabul qiladi. Shablonsiz Telegramga text maydoni (yoki message, content) keladi, u boʻlmasa — soʻrovning barcha maydonlari «maydon: qiymat» satrlari koʻrinishida.

Shablon bilan JSON maydonlari matnga jingalak qavslar ichida qoʻyiladi. Masalan, «Yangi buyurtma #{order.id}, summa {amount}» shabloni va {"order": {"id": 1024}, "amount": 59} soʻrovi «Yangi buyurtma #1024, summa 59» xabarini beradi. Roʻyxat elementlariga tartib raqami orqali murojaat qilish mumkin: {items.0.name}.

«Buxgalteriya» uchun summa amount maydonidan olinadi (1500 yoki -249.90), boshqa kategoriya — category maydonidan (buyruq yoki nom), izoh esa shablon boʻyicha yoki comment maydonidan.

5-qadam. Tekshiring va jurnalni kuzatib boring

Vebxuk yonidagi Tekshirish tugmasi toʻgʻridan-toʻgʻri kabinetdan sinov soʻrovini yuboradi. Soʻrov haqiqatan bajariladi, oynaning pastida esa servisingiz uchun tayyor curl buyrugʻi bor. Har bir vebxukda soʻrovlar hisoblagichi, oxirgi soʻrov vaqti va Jurnal bor: nima keldi, nima qilindi va xato boʻlsa, qanday xato (masalan, «Summa yoʻq» yoki «Akkaunt oflayn»). Almashtirgich bilan vebxukni oʻchirib tashlamasdan, vaqtincha toʻxtatib qoʻyish mumkin.

Akkauntdan xabar tarif toʻlangan va akkaunt onlayn boʻlsa yuboriladi; bitta vebxukka daqiqasiga 30 tadan ortiq soʻrov yuborib boʻlmaydi.

Agar teskarisi kerak boʻlsa

Zion hodisalari — uzatishdagi yangi xabarlar, «Alertlar» ishga tushishi, topilgan dublikatlar, cheklar — servisingizga oʻzi kelishi uchun chiquvchi vebxuklardan foydalaning: oʻsha varaqdagi Chiquvchi tugmasi. Ular hodisalarni imzo bilan Discord, Slack, MAX yoki sizning manzilingizga yuboradi.

Batafsil: Vebxuklar va API.