Socialift kabineti: har bir bo'lim nima qiladi
Socialift kabineti (socialift.uz/dashboard) yettita bo'limdan iborat: «Tokenlar» — SDK litsenziya kalitlari, «Playground» — 191 metodni kod yozmasdan sinash, «Ulanishlar» — akkaunt va botlarni ulash, «Kalitlar» — o'z developer app kalitlaringiz, «Statistika» — SDK aktivatsiyalari va API so'rovlari, «Hisob» — balans va to'lov, «Qo'llanma» — boshlash yo'riqnomasi.
Yangilangan:
Kabinet nima uchun kerak?
Ikki vazifa uchun. Birinchisi — SDK uchun litsenziya kalitini olish va uning holatini kuzatish («Tokenlar», «Statistika», «Hisob»). Ikkinchisi — metodlarni haqiqiy akkauntlarda kod yozmasdan sinash («Ulanishlar», «Kalitlar», «Playground»). Kabinetda ulangan akkauntlar va kalitlar Socialift serverida qoladi: o'z ilovangizdagi SDK ularni ishlatmaydi, u sizning kalit va tokenlaringiz bilan ishlaydi.
Bo'limlar bir qarashda
| Bo'lim | Manzil | Nima qiladi |
|---|---|---|
| «Tokenlar» | /dashboard | Litsenziya kalitlarini olish, ko'rish, uzaytirish va tekshirish |
| «Playground» | /dashboard/playground | 191 metodning hujjati, formasi va jonli so'rovi |
| «Ulanishlar» | /dashboard/connections | Facebook, Instagram, LinkedIn, TikTok, Telegram akkaunt va botni ulash |
| «Kalitlar» | /dashboard/apps | O'z developer app kalitlaringizni saqlash va tekshirish |
| «Statistika» | /dashboard/usage | SDK aktivatsiyalari va Playground/API so'rovlari, xatolar bilan |
| «Hisob» | /dashboard/billing | Balans va hisobni to'ldirish |
| «Qo'llanma» | /dashboard/guide | O'rnatish, kalitni sozlash va birinchi chaqiruv namunalari |
«Tokenlar»: litsenziya kalitlari
«Yangi token» litsenziya kalitini yaratadi: birinchi oy bepul va bu davrda SDK'ning barcha imkoniyatlari ochiq, token 1 seat bilan chiqadi. Bir vaqtda 5 tagacha faol token bo'lishi mumkin. Har bir kartada key_id, reja, holat, «bepul sinov» belgisi va qolgan kunlar ko'rinadi.
«Kalitni ko'rsatish» to'liq slk_... kalitni ochadi, «Nusxa» uni buferga ko'chiradi. «30 kunga uzaytirish» balansdan to'lovni yechib, tokenga 30 kun qo'shadi: muddat tugamagan bo'lsa qolgan muddat ustiga, tugagan bo'lsa bugundan boshlab (bu holda tugma «Qayta faollashtirish» deb ataladi). Mablag' yetmasa, xabar chiqadi — «Hisobni to'ldirish» havolasi shu uchun. Uzaytirilgan token imkoniyatlari uning rejasiga bog'liq, kalit esa o'sha key_id bilan qayta imzolanadi: SDK 1.3+ yangi muddatni serverdan o'zi oladi, PyPI'dagi 1.2.x yoki SOCIALIFT_LICENSE_OFFLINE=1 bilan esa SOCIALIFT_LICENSE_KEY ni «Kalitni ko'rsatish» ochgan yangi kalitga almashtiring.
«Tekshirish va muhitlar» seat egallamaydi. U kalit SDK bilan ishlaydimi, reja, band seat'lar, lease muddati, oxirgi aktivatsiya, ochiq imkoniyatlar va seat egallagan muhitlar jadvalini ko'rsatadi. Barcha seat'lar band bo'lsa, yangi server yoki konteyner rad etilishi haqida ogohlantiradi.
«Playground»: 191 metodni kod yozmasdan sinash
Chapda metodlar ro'yxati: qidiruv, platforma filtri (Facebook, Instagram, LinkedIn, TikTok, Telegram akkaunt, Telegram bot, CRM va lead'lar, ulangan akkauntlar) va bo'limlar. Metod tanlanganda HTTP metod va yo'l, amal turi, kerakli ruxsatlar (scope), hujjat va eslatmalar chiqadi.
«So'rov» panelida «Qaysi akkaunt nomidan» ro'yxati metodga mos ulangan akkauntlarni ko'rsatadi; mos akkaunt bo'lmasa, «Ulanishlar» ga havola chiqadi. Parametrlar forma yoki JSON ko'rinishida to'ldiriladi. «Yuborish» so'rovni Socialift serveri orqali siz ulagan akkaunt nomidan haqiqiy platformaga jo'natadi.
«Javob» panelida status kodi, vaqt (ms), hajm, tana va sarlavhalar bor; fayl javoblari (masalan, rasm) ko'rsatiladi va yuklab olinadi. «Kod» panelida uchta yorliq: «Python SDK» — platformaga to'g'ridan-to'g'ri murojaat qiladigan SDK kodi (kalit va tokenlar sizning ilovangizda); «cURL» va «JavaScript» — Playground aynan yuboradigan Socialift server API so'rovi, kabinet sessiyasining JWT'si bilan. Ba'zi amallar faqat server API'da bor — ularda Python yorlig'i buni ochiq aytadi.
So'nggi so'rovlar tarixi va har metod uchun tanlangan akkaunt faqat brauzeringizda (localStorage) saqlanadi.
Playground'dagi amal turlari va tasdiqlar
| Belgi | Ma'nosi | Yuborishdan oldin |
|---|---|---|
| «Faqat o'qiydi» | Hech narsani o'zgartirmaydi | Tasdiq kerak emas |
| «O'zgartiradi» | Platformada haqiqiy o'zgarish: post, xabar, sozlama | Tasdiq so'ralmaydi — so'rov baribir haqiqiy |
| «O'chiradi» | Qaytarib bo'lmaydigan amal; ro'yxatda qizil nuqta | «Tushundim, yuborilsin.» belgilanmaguncha «Yuborish» o'chiq |
| «Byudjetga ta'sir» | Reklama byudjetini sarflashi mumkin; ro'yxatda sariq nuqta | «Tushundim, yuborilsin.» belgilanmaguncha «Yuborish» o'chiq |
| «Ulanish» | Ulanish yoki token bilan ishlaydi | Tasdiq kerak emas |
Izohlar va cheklovlar
Tasdiq har yuborishdan keyin qayta so'raladi. Boshqa bo'limlarda ham himoya bor: «Ulanishlar» dagi «Uzish» brauzerning tasdiq oynasini ochadi; «Kalitlar» da akkauntlar ulangan kalitni o'chirishga urinish ulangan akkauntlar ro'yxatini ko'rsatib to'xtaydi va faqat «Baribir o'chirish va uzish» bilan davom etadi.
«Ulanishlar»: akkauntlarni qanday ulash mumkin?
Facebook, «Instagram (Page'siz)», LinkedIn va TikTok «Ulash» tugmasi bilan OAuth orqali ulanadi. Facebook ulangach «Page'larni sinxronlash» ni bosing — Page'lar va ularga bog'langan Instagram akkauntlari qo'shiladi. «Instagram (Page'siz)» — Instagram Login orqali professional (Business yoki Creator) akkaunt.
«Telegram akkaunt»: telefon raqami → tasdiqlash kodi (odatda SMS emas, Telegram ilovasining o'ziga keladi) → ikki bosqichli parol yoqilgan bo'lsa, parol. «Telegram bot»: @BotFather bergan token, app kaliti kerak emas. Bot guruhlarda faqat o'ziga yozilgan xabarlarni ko'rsa, kabinet BotFather'da Group Privacy'ni o'chirishni tavsiya qiladi.
Tokenlar serverda shifrlangan holda saqlanadi va brauzerga yuborilmaydi. Har bir akkaunt qatorida token amal qilish sanasi (yoki «muddatsiz»), «qayta ulash kerak» belgisi, «Token'ni yangilash» (Page'siz Instagram, LinkedIn, TikTok), Playground'ga tezkor havola va «Uzish» bor. Telegram akkauntini uzish Telegram seansini ham tugatadi; Facebook shaxsiy akkaunti va TikTok uchun berilgan ruxsat bekor qilinadi.
Platformada ham o'z app'ingiz, ham Socialift app'i mavjud bo'lsa, kartada «Qaysi kalit bilan» tanlovi chiqadi: «O'z app'im» yoki «Socialift app'i».
«Kalitlar»: o'z developer app'ingiz yoki Socialift'ning umumiy app'i?
«Kalitlar» bo'limida beshta provayder uchun o'z kalitlaringizni saqlaysiz: «Meta (Facebook) app», «Instagram Login app», «LinkedIn app», «TikTok app» va «Telegram API (my.telegram.org)». O'z app'ingiz bo'lsa, login oynasida sizning app nomingiz ko'rinadi, webhook'lar sizning secret'ingiz bilan imzolanadi va limitlar sizniki bo'ladi. Kalit qo'yilmasa, Socialift'ning umumiy kaliti ishlatiladi (u mavjud bo'lsa).
Maydonlar: client ID, secret, kerak bo'lsa config_id va scope'lar, nom va «Faol» belgisi. Secret shifrlangan saqlanadi va hech qachon to'liq qaytarilmaydi — faqat oxirgi belgilari ko'rsatiladi; o'zgartirmaslik uchun maydonni bo'sh qoldiring.
«Saqlash va tekshirish» kalitni provayderning o'zida tekshiradi. Natija uch xil: tekshirilgan, rad etilgan yoki oldindan tekshirib bo'lmaydi (masalan, tarmoq xatosi) — oxirgisi to'g'ri ham, buzuq ham deb ko'rsatilmaydi. Holat belgisi: «O'z kalitingiz ishlatiladi», «Socialift kaliti ishlatiladi» yoki «Sozlanmagan».
O'ng panelda «Qanday olinadi» (konsol havolasi bilan qadamlar) va «Konsolga ko'chiring» bor: provayderga qarab Redirect URI, Webhook URL, Webhook verify token, Deauthorize callback va Data deletion callback. Webhook URL va verify token kalit saqlangandan keyin chiqadi.
Yangi ulanishda qaysi kalit ishlatiladi?
1. O'z kalitingiz
«Kalitlar» da shu provayder uchun faol kalit bo'lsa, u ishlatiladi.
2. Socialift kaliti
O'z kalitingiz yo'q yoki nofaol bo'lsa, Socialift'ning umumiy kaliti ishlatiladi (mavjud bo'lsa).
Ikkalasi ham bo'lsa
«Ulanishlar» kartasida «O'z app'im» yoki «Socialift app'i» ni o'zingiz tanlaysiz.
Hech biri bo'lmasa
Karta «Kalit sozlanmagan» deb yozadi va «Kalitlar» ga havola beradi.
Ulangandan keyin
Akkaunt qaysi app orqali ulangan bo'lsa, o'shanga bog'lanib qoladi: Meta'ning
appsecret_proofi, TikTok va LinkedIn tokenini yangilash aynan o'sha app secret'ini talab qiladi. Kalitni nofaol qilsangiz, mavjud akkauntlar ishlashda davom etadi, yangi ulanishlar esa Socialift kalitiga o'tadi. Akkauntlar ulangan kalitni o'chirsangiz, akkauntlar uziladi va ularning tokenlari ishlamay qoladi.
«Statistika»: nima sanaladi va nima sanalmaydi?
| Manba | Sanaladimi | Qanday |
|---|---|---|
| SDK litsenziya aktivatsiyalari | Ha | Ishga tushishda va har lease yangilanishida (standart 12 soat), token bo'yicha; imzosi to'g'ri kalitning rad etilgan aktivatsiyalari xato sifatida |
| Playground va kabinet JWT'si bilan server API | Ha | Faqat platforma endpoint'lari (Facebook, Instagram, LinkedIn, TikTok, Telegram, CRM), foydalanuvchi bo'yicha |
| SDK'ning platformalarga har bir chaqiruvi | Yo'q | SDK Socialift serveri orqali o'tmaydi — faqat aktivatsiyalar ko'rinadi |
| Kabinetning ichki so'rovlari | Yo'q | Profil, tokenlar, hisob, statistika, kalitlar va Playground katalogi |
| Webhook'lar va anonim so'rovlar | Yo'q | Ularni platformalar yoki noma'lum mijozlar chaqiradi |
Izohlar va cheklovlar
Xato — HTTP 4xx yoki 5xx bilan tugagan so'rov. Endpoint ID bilan emas, shablon ko'rinishida saqlanadi (masalan, /facebook/posts/{post_id}); mos marshrut topilmagan so'rovlar bitta «(noma'lum endpoint)» qatoriga yig'iladi.
«Statistika» sahifasida nima ko'rinadi?
Davr: 7, 30 yoki 90 kun. Yuqorida to'rt ko'rsatkich: jami so'rovlar, xatolar (foizi bilan), «SDK aktivatsiyalari» va «Playground / API». «Kunlik so'rovlar» grafigi SDK va Playground/API'ni alohida rangda ko'rsatadi va «Jadval» ko'rinishiga o'tkaziladi.
«Kalitlar bo'yicha» jadvali har bir manba (token yoki foydalanuvchi) uchun so'rovlar, xatolar va oxirgi kunni beradi; «Eng ko'p ishlatilgan endpoint'lar» — metod, endpoint, so'rov va xato soni.
«Hisob» va «Qo'llanma»
«Hisob» joriy balansni ko'rsatadi. To'ldirish: summani so'mda kiriting, karta turini (Humo yoki Uzcard) tanlang va «Davom etish» ni bosing. Kabinet karta raqami va aniq summani ko'rsatadi — aynan shu summani o'tkazing, chunki tizim to'lovni summa bo'yicha topadi, keyin «To'ladim — tekshirish» ni bosing. Tanlangan summa band bo'lsa, kabinet yaqin muqobil summalarni taklif qiladi. Balans tokenni «30 kunga uzaytirish» uchun ishlatiladi.
«Qo'llanma»: Playground'ga havola, seat egallamaydigan tokenni tekshirish (reja, seat'lar, qolgan kunlar, imkoniyatlar), o'rnatish buyruqlari, SOCIALIFT_LICENSE_KEY va SOCIALIFT_INSTANCE_ID sozlamasi, Facebook/Instagram, TikTok, Telegram va reklama uchun birinchi chaqiruv namunalari, xatolarni ishlash namunasi va qo'llab-quvvatlash manzili hello@socialift.uz.
Playground'dan o'z ilovangizga qanday o'tiladi?
«Python SDK» yorlig'idagi kod platformaga to'g'ridan-to'g'ri murojaat qiladi. Uni ilovaga ko'chirganda kalit va tokenlarni koddan muhit o'zgaruvchilariga olib chiqing.
import asyncio
import os
from socialift import Telegram
async def main():
# Playground'da: bot = Telegram(token="123456:AA...") va me = await bot.get_me()
async with Telegram(token=os.environ["TELEGRAM_BOT_TOKEN"]) as bot:
me = await bot.get_me()
print(me["username"])
asyncio.run(main())Ilovada SOCIALIFT_LICENSE_KEY ham kerak — uni «Tokenlar» dan oling. Kabinetda ulangan bot yoki akkaunt SDK'ga o'tmaydi: token o'zingizda bo'lishi kerak.
Kabinetda xavfsizlik bo'yicha eslatmalar
- Ochilgan
slk_...kalitni chat yoki repozitoriyga joylamang; sizib chiqsa, hello@socialift.uz ga yozing. - Playground so'rovlari haqiqiy: «O'zgartiradi» belgili metodlar ham post chiqaradi va xabar yuboradi.
- «O'chiradi» va «Byudjetga ta'sir» amallarida tasdiq belgisini faqat so'rov tanasini tekshirgandan keyin qo'ying.
- Platforma tokenlari va app secret'lar serverda shifrlangan: token brauzerga yuborilmaydi, secret to'liq ko'rsatilmaydi.
- Keraksiz akkauntlarni «Uzish» bilan uzing — Telegram akkauntida bu seansni ham tugatadi.
Ko'p so'raladigan savollar
Kabinetda ulangan akkaunt tokenini o'z kodimda ishlatsam bo'ladimi?
Yo'q. Kabinetdagi tokenlar serverda shifrlangan holda saqlanadi va brauzerga ham yuborilmaydi. O'z ilovangizda token OAuth orqali olinadi (login_url() → exchange_code()) va sizning bazangizda saqlanadi.
«Tekshirish va muhitlar» tugmasi seat egallaydimi?
Yo'q. U SDK aktivatsiyasini chaqirmaydi, faqat saqlangan holatni o'qiydi, shuning uchun uni xohlagancha bosish mumkin. Seat'ni faqat SDK'ning yangi muhitdagi haqiqiy aktivatsiyasi egallaydi.
Playground so'rovlari haqiqiymi yoki sinov rejimidami?
Haqiqiy: so'rov Socialift serveri orqali siz ulagan akkaunt nomidan platformaga yuboriladi — post e'lon qilinadi, xabar ketadi. Shuning uchun o'chirish va reklama byudjetiga ta'sir qiladigan amallar alohida tasdiq so'raydi.
O'z app kalitimni qo'shsam, oldin ulangan akkauntlar nima bo'ladi?
Ular qaysi app orqali ulangan bo'lsa, o'shanga bog'langan holda ishlashda davom etadi. Yangi kalit keyingi ulanishlarda ishlatiladi; akkauntni o'z app'ingizga o'tkazish uchun uni qayta ulang.
«Statistika» da SDK chaqiruvlari nega kam ko'rinadi?
SDK Instagram, TikTok va boshqa platformalarga Socialift serveri orqali emas, to'g'ridan-to'g'ri murojaat qiladi. Shuning uchun faqat litsenziya aktivatsiyalari — ishga tushishda va har lease yangilanishida (standart 12 soat) — sanaladi. Metod darajasidagi statistika faqat Playground va server API so'rovlari uchun bor.
Hisobni to'ldirdim, lekin balans o'zgarmadi. Nima qilish kerak?
Aynan kabinet ko'rsatgan summani ko'rsatilgan kartaga o'tkazganingizni tekshiring — tizim to'lovni summa bo'yicha topadi. Keyin «To'ladim — tekshirish» ni bosing; to'lov hali topilmagan bo'lsa, kabinet shuni aytadi. Muammo qolsa, hello@socialift.uz ga yozing.