⚡ PLUTONIUM 4.0 REST API v0.1

Developer Documentation

PremiumMod — Telegram guruhlaringizni xavfsiz va toza saqlash uchun mo'ljallangan ilg'or moderatsiya tizimi. Bot real vaqtda spam, firibgarlik va raid hujumlarini SHIELD 4.0 orqali bartaraf etadi.

🔑 Autentifikatsiya Tizimi

API ikkita xavfsiz avtorizatsiya usulini qo'llab-quvvatlaydi:

Usul Header formati Ishlatilishi
Telegram Mini App Authorization: tma <initData> Mini App orqali xavfsiz guruh va profilingizni boshqarish
Telegram ID Auth Authorization: id <user_id> Brauzerda to'g'ridan-to'g'ri ID orqali panelga kirish
API Key x-api-key: your-api-key Serverlararo boshqaruv va admin integratsiyalari

🚀 Botni Guruhga O'rnatish

  1. Telegramda botni qidiring: @bot
  2. "Guruhga qo'shish" tugmasini bosing va kerakli guruhingizni tanlang.
  3. Botga barcha Administrator huquqlarini bering.
  4. Guruhda /reload buyrug'ini yuboring.
  5. Guruh ichida /settings yuborib, Web panel yoki tugmalar orqali sozlang.

📌 Asosiy Buyruqlar Ro'yxati

Barcha buyruqlar ham slash (/), ham nuqta (.) prefiksi bilan ishlaydi.

BuyruqMuqobiliVazifasi
/warn.warnQoidabuzarga ogohlantirish berish
/mute.mute [vaqt]Read-only (ovozsiz) rejimga tushirish
/kick.kickFoydalanuvchini guruhdan chiqarish
/ban.banGuruhdan butunlay chetlatish
/unban.unbanBandan chiqarish
/unmute.unmuteMutedan chiqarish
/shield.shieldSHIELD 4.0 holati va anti-raid
.lock / .unlock—Guruhni barcha uchun yopish / ochish
/settings.settingsGuruh sozlamalari Web paneli
GET /api/v0.1/public/stats

Botning real vaqtdagi global umumiy statistikasi (Start foydalanuvchilar va Guruh auditoriyasi).

curl -X GET "https://premiummod.uz/api/v0.1/public/stats"

Response (200 OK):

{ "version": "4.0.0", "codename": "PLUTONIUM", "users_total": 5859, "start_users": 1420, "total_audience": 48200, "groups_total": 26, "groups_active": 25, "messages_deleted": 4756, "total_warns": 4772, "total_bans": 22 }
POST /api/v0.1/support

Web sayt orqali to'g'ridan-to'g'ri bot egasiga support ticket yuborish.

curl -X POST "https://premiummod.uz/api/v0.1/support" \ -H "Content-Type: application/json" \ -d '{"name": "Kamron", "contact": "@username", "message": "Yordam kerak..."}'
GET /api/v0.1/me/groups

Foydalanuvchi boshqaruvidagi yoki bot ulangan barcha guruhlar ro'yxatini qaytaradi.

curl -X GET "https://premiummod.uz/api/v0.1/me/groups" \ -H "Authorization: id 123456789"
GET /api/v0.1/me/groups/{group_id}/members

Guruh a'zolari ro'yxati, xabarlar soni va ogohlantirishlar holati.

curl -X GET "https://premiummod.uz/api/v0.1/me/groups/-100123456789/members" \ -H "Authorization: id 123456789"
GET /api/v0.1/me/users/{user_id}/details

Foydalanuvchining to'liq profili, ogohlantirishlari va qatnashayotgan guruhlari.

curl -X GET "https://premiummod.uz/api/v0.1/me/users/123456789/details" \ -H "Authorization: id 123456789"
POST /api/v0.1/me/groups/{group_id}/members/{user_id}/action

Foydalanuvchiga nisbatan guruhda real-vaqtda jazo qo'llash (warn, unwarn, mute, kick, ban).

curl -X POST "https://premiummod.uz/api/v0.1/me/groups/-100123456789/members/123456/action" \ -H "Authorization: id 123456789" \ -H "Content-Type: application/json" \ -d '{"action": "warn", "reason": "Spam yuborish"}'
PATCH /api/v0.1/me/groups/{group_id}/settings

Guruh moderatsiya parametrlarini yangilash (anti_ads, anti_badwords, warn_limit).

curl -X PATCH "https://premiummod.uz/api/v0.1/me/groups/-100123456789/settings" \ -H "Authorization: id 123456789" \ -H "Content-Type: application/json" \ -d '{"anti_ads": true, "anti_badwords": true, "warn_limit": 3}'