Telegram api_id va api_hash: olish, xavfsizlik va qoidalar

api_id va api_hash nima?

my.telegram.org'da api_id olish: qadamlar

1. 1

   Rasmiy ilovada akkaunt oching

   Telegram talabi: avval rasmiy Telegram ilovasi orqali ro'yxatdan o'tgan bo'lishingiz kerak. Faol, o'zingizga tegishli raqamdan foydalaning — Telegram muhim dasturchi xabarnomalarini shu raqamga yuboradi.

2. 2

   my.telegram.org'ga kiring

   https://my.telegram.org saytini oching, raqamni xalqaro formatda (+998...) kiriting va kelgan tasdiqlash kodini yozing.

3. 3

   «API development tools» bo'limiga o'ting

   Bu bo'limda yangi ilova yaratish formasi turadi.

4. 4

   Formani to'ldiring

   Ilova nomi, qisqa nomi va boshqa maydonlarni to'ldiring. ToS bo'yicha ilova nomida «Telegram» so'zi bo'lmasligi kerak (faqat «Unofficial» so'zidan keyin kelishi mumkin) va rasmiy Telegram logotipini ishlatib bo'lmaydi.

5. 5

   api_id va api_hash'ni saqlang

   Sahifada api_id, api_hash va MTProto server manzillari chiqadi. Kalitlarni kodga yozmang: TELEGRAM_API_ID va TELEGRAM_API_HASH muhit o'zgaruvchilariga yoki sirlar omboriga joylang.

6. 6

   Socialift'da ulang (ixtiyoriy)

   Kabinetda Kalitlar → Telegram bo'limiga api_id va api_hash'ni kiriting — ular shifrlab saqlanadi va Telegram'da tekshiriladi. So'ng Ulanishlar → Telegram akkaunt'da telefon → kod → kerak bo'lsa 2FA parol bilan akkauntni ulaysiz.

Telegram API Terms of Service: nimalarga e'tibor berish kerak

Rasmiy «Creating your Telegram Application» sahifasi va API Terms of Service'dan asosiy bandlar.

Login oqimi: telefon → kod → 2FA parol

Veb-ilovada login ikki HTTP so'rovga bo'linadi. Birinchi qadam qaytargan phone_code_hash faqat o'sha oraliq sessiya ichida yaroqli, shuning uchun ikkalasini keyingi qadamga uzatasiz.

import os
from socialift import TelegramAccount

API_ID = int(os.environ["TELEGRAM_API_ID"])
API_HASH = os.environ["TELEGRAM_API_HASH"]

async def start_login(phone: str) -> dict:
    async with TelegramAccount(api_id=API_ID, api_hash=API_HASH) as tg:
        return await tg.send_code(phone)  # phone_code_hash + oraliq session

async def finish_login(phone: str, code: str, sent: dict, password: str | None = None) -> str:
    async with TelegramAccount(api_id=API_ID, api_hash=API_HASH,
                               session=sent["session"]) as tg:
        result = await tg.sign_in(phone, code, phone_code_hash=sent["phone_code_hash"])
        if result["two_factor_required"]:
            result = await tg.sign_in_password(password)
        return tg.export_session()  # parolga teng — shifrlab saqlang

Saqlangan sessiya bilan qayta ulanish

import os
from socialift import TelegramAccount

async def get_account() -> TelegramAccount:
    tg = TelegramAccount(api_id=int(os.environ["TELEGRAM_API_ID"]),
                         api_hash=os.environ["TELEGRAM_API_HASH"],
                         session=os.environ["TELEGRAM_SESSION"])
    await tg.connect()
    if not await tg.is_authorized():
        await tg.disconnect()
        raise RuntimeError("Sessiya bekor qilingan — qayta login kerak")
    return tg

Sessiya satrini xavfsiz saqlash

export_session() qaytargan satr akkauntga to'liq kirish beradi — kod, parol va 2FA'siz.

• ▸Bazada faqat shifrlangan holda saqlang (masalan, KMS yoki alohida shifrlash kaliti bilan), kalitni baza bilan bir joyda saqlamang.
• ▸Sessiyani logga, xatolar monitoringiga va brauzerga chiqarmang.
• ▸Bitta sessiyani bir vaqtda ikki jarayonda ishlatmang: Telegram bitta avtorizatsiyadan parallel asosiy ulanishlarni ko'rsa AUTH_KEY_DUPLICATED beradi va sessiyani bekor qiladi — qayta login kerak bo'ladi.
• ▸Har bir akkaunt uchun alohida sessiya; bitta satrni serverlar orasida nusxalamang.
• ▸Kerak bo'lmay qolgan sessiyani log_out() bilan yoping; begona qurilmalarni sessions() va reset_session() bilan tekshirib tugating.
• ▸Yangi login bo'lganda boshqa sessiyalarga bildirishnoma boradi — akkaunt egasini bundan oldindan ogohlantiring.

Ban va FLOOD_WAIT xavfi: mas'uliyatli foydalanish

FLOOD_WAIT'ni ushlash

import asyncio
from socialift import RateLimitError

async def send_report(tg, text: str) -> None:
    try:
        await tg.send_message("@mening_guruhim", text)
    except RateLimitError as exc:        # Telegram: FLOOD_WAIT_X
        if (exc.retry_after or 0) > 300:
            raise                          # uzoq kutish — vazifani keyinga qoldiring
        await asyncio.sleep(exc.retry_after or 5)
        await tg.send_message("@mening_guruhim", text)