Socialift SDK bilan tez boshlash

Qisqacha: Socialift SDK bilan qanday boshlanadi?

Boshlash uchun nima kerak?

1-qadam: SDK'ni o'rnatish va kalitni sozlash

1. 1

   Paketni o'rnating

   pip install socialift. Asosiy bog'liqliklar faqat aiohttp va cryptography. Jonli Telegram akkaunti (TelegramAccount, MTProto) kerak bo'lsa: pip install 'socialift[telegram]' — Telethon qo'shiladi; Telegram bot uchun bu shart emas.

2. 2

   Litsenziya kalitini oling

   socialift.uz/dashboard → «Tokenlar» → «Yangi token». Kalit slk_ bilan boshlanadi; uni «Kalitni ko'rsatish» va «Nusxa» tugmalari bilan oling. Birinchi oy bepul va bu davrda SDK'ning barcha imkoniyatlari ochiq.

3. 3

   Kalitni muhit o'zgaruvchisiga yozing

   SOCIALIFT_LICENSE_KEY=slk_.... Kalitni kodga yozmang — klientlar uni muhitdan o'zi o'qiydi. Kalit import paytida emas, birinchi so'rovdan oldin tekshiriladi.

4. 4

   Konteynerda muhit nomini bering

   Docker yoki Kubernetes'da SOCIALIFT_INSTANCE_ID=my-app-prod kabi barqaror qiymat qo'ying — aks holda har deploy yangi seat egallaydi. Batafsil — «Autentifikatsiya» sahifasida.

Terminalda: o'rnatish va kalit

python -m pip install socialift
python -m pip install "socialift[telegram]"   # faqat TelegramAccount (MTProto) uchun

export SOCIALIFT_LICENSE_KEY="slk_..."
# Windows PowerShell: $env:SOCIALIFT_LICENSE_KEY="slk_..."

python -c 'import socialift; print(socialift.__version__)'

A yo'l: Telegram bot — bir necha daqiqada birinchi xabar

@BotFather'da /newbot bilan bot yarating, tokenni TELEGRAM_BOT_TOKEN ga yozing va botga Telegram'da istalgan xabar yuboring — skript chat ID ni shu xabardan oladi.

import asyncio
from socialift import Telegram


async def main():
    async with Telegram.from_env() as bot:        # TELEGRAM_BOT_TOKEN dan o'qiydi
        me = await bot.get_me()
        print("Bot:", me["username"])

        updates = await bot.get_updates(timeout=0)
        messages = [u["message"] for u in updates if "message" in u]
        if not messages:
            print("Avval botga Telegram'da xabar yozing")
            return
        chat_id = messages[-1]["chat"]["id"]
        await bot.send_message(chat_id, "Salom! Socialift SDK ishlayapti.")


asyncio.run(main())

B yo'l: Facebook va Instagram — OAuth orqali

Instagram Business yoki Creator akkaunti Facebook Page'ga ulangan bo'lsa, token Facebook Login orqali olinadi va Instagram so'rovlari page token bilan yuboriladi.

1. 1

   Meta app yarating

   developers.facebook.com'da app yarating, App ID va App Secret'ni FACEBOOK_APP_ID va FACEBOOK_APP_SECRET ga yozing. Batafsil — «Meta app sozlash» qo'llanmasida.

2. 2

   Redirect URI'ni ro'yxatga oling

   Facebook Login sozlamalariga callback manzilingizni qo'shing (masalan https://example.uz/auth/facebook/callback). login_url() va exchange_code() ga aynan shu manzil belgi-ma-belgi berilishi shart.

3. 3

   Ruxsatlarni so'rang

   Page'lar va ularga ulangan Instagram akkauntini o'qish uchun pages_show_list va instagram_basic kerak. Facebook Login for Business konfiguratsiyasi ishlatilsa, scopes o'rniga config_id beriladi.

4. 4

   Foydalanuvchini login oynasiga yuboring

   fb.login_url(...) havola qaytaradi. state ni sessiyada saqlang va callback'da solishtiring — SDK uni saqlamaydi.

5. 5

   Callback'da token va Page'larni oling

   exchange_code() kodni uzoq muddatli user tokenga almashtiradi, pages() esa Page'larni page tokeni va ulangan Instagram ID si bilan qaytaradi.

Login havolasini yaratish

import secrets
from socialift import Facebook

REDIRECT_URI = "https://example.uz/auth/facebook/callback"

fb = Facebook.from_env()              # FACEBOOK_APP_ID, FACEBOOK_APP_SECRET
state = secrets.token_urlsafe(32)     # sessiyada saqlang
url = fb.login_url(
    redirect_uri=REDIRECT_URI,
    state=state,
    scopes=["pages_show_list", "instagram_basic"],
)
print(url)

Callback: token, Page'lar va Instagram profili

import asyncio
import os
from socialift import Facebook, Instagram

REDIRECT_URI = "https://example.uz/auth/facebook/callback"


async def handle_callback(code: str):
    async with Facebook.from_env() as fb:
        user = await fb.exchange_code(code, redirect_uri=REDIRECT_URI)
        pages = await fb.pages(user.access_token)

    async with Instagram.via_facebook(app_secret=os.environ["FACEBOOK_APP_SECRET"]) as ig:
        for page in pages:
            if not page.instagram_id:
                continue
            profile = await ig.profile(page.access_token, ig_user_id=page.instagram_id)
            posts = await ig.media(page.access_token, ig_user_id=page.instagram_id, limit=5)
            print(page.name, "->", profile.username, len(posts), "ta post")


asyncio.run(handle_callback(code="callback URL'dagi code parametri"))

Kod yozmasdan sinash: Playground

Keyingi qadamlar: ishlab chiqarishdan oldin

• ▸Konteynerlarda SOCIALIFT_INSTANCE_ID ni barqaror qiymatga qo'ying — «Autentifikatsiya» sahifasi.
• ▸AuthError, PermissionError va RateLimitError ni alohida ishlang — «Xatolar» sahifasi.
• ▸Webhook imzosini xom tana bo'yicha tekshiring — «Webhook'lar» sahifasi.
• ▸Token muddatini kuzating: TokenBundle.expires_at va is_expiring().
• ▸Barcha metodlar va parametrlar — SDK reference sahifalarida.