آموزش ساخت API ID و API Hash تلگرام؛ رفع Error سایت my.telegram.org
تیم سوشال گرو
اگر قصد ساخت ربات یا اجرای پروژههای برنامهنویسی تلگرام را داشته باشید، احتمالاً جایی از کار به API ID و API Hash نیاز پیدا میکنید.
بهصورت معمول برای دریافت این دو مقدار باید وارد سایت my.telegram.org شوید و از بخش Developer یک اپلیکیشن جدید بسازید. اما این روزها بعضی کاربران هنگام ساخت API با خطا مواجه میشوند و اطلاعات موردنظرشان ساخته نمیشود.
در این مطلب خیلی ساده توضیح میدهیم که API ID و API Hash را از کجا بگیرید و اگر سایت تلگرام برای ساخت آن خطا داد، چه کاری میتوانید انجام دهید.
API ID و API Hash تلگرام چیست؟
قبل از هر چیز بد نیست بدانیم این دو مقدار دقیقاً چه کاربردی دارند.
API ID یک شناسه برای اپلیکیشن شماست و API Hash هم مقدار اختصاصی همان اپلیکیشن است. بعضی کتابخانهها و پروژههای تلگرامی مثل Telethon و Pyrogram برای اتصال به Telegram API به این اطلاعات نیاز دارند.
این موارد با توکن ربات که از BotFather میگیرید فرق دارند. بنابراین اگر در یک آموزش از شما API ID و API Hash خواسته شده، Bot Token بهتنهایی کافی نیست.
چطور از my.telegram.org API ID و API Hash بگیریم؟
روش معمول دریافت این اطلاعات از سایت رسمی تلگرام به این شکل است:
- وارد سایت my.telegram.org شوید.
- شمارهای که با آن در تلگرام حساب دارید وارد کنید.
- کد ورود را وارد کنید.
- بعد از ورود، وارد بخش API development tools شوید.
- اطلاعات خواستهشده برای ساخت اپلیکیشن را وارد کنید.
- فرم را ثبت کنید.
اگر همه چیز درست پیش برود، در همین بخش API ID و API Hash نمایش داده میشوند.
چرا my.telegram.org برای ساخت API خطا میدهد؟
مشکل اصلی اینجاست که گاهی بعد از پر کردن فرم، بهجای ساخته شدن API با پیام ERROR مواجه میشوید.
این مشکل ممکن است دلایل مختلفی داشته باشد. برای مثال ممکن است قبلاً برای شماره شما API ساخته شده باشد یا خود بخش Developer در آن لحظه درست کار نکند.
بنابراین اگر فرم را چند بار پر کردید و هر بار با خطا مواجه شدید، لازم نیست پشت سر هم دوباره امتحان کنید. ابتدا وضعیت حساب و APIهای قبلی را بررسی کنید.
اگر API ID در my.telegram.org ساخته نشد چه کار کنیم؟
اگر با خطای سایت مواجه شدهاید و نمیتوانید API ID موردنیازتان را دریافت کنید، یک راه ساده دیگر هم وجود دارد.
ربات @ApiHashGeneratorBot برای همین موضوع در تلگرام در دسترس است و میتوانید آن را بررسی کنید:
🤖 دریافت API با ApiHashGeneratorBot
اگر بخش Developer سایت برای شما خطا میدهد، میتوانید وارد ربات شوید و مراحل آن را دنبال کنید. این گزینه برای کسانی که فقط میخواهند سریعتر به اطلاعات موردنیاز پروژه تلگرامی خود برسند، میتواند کاربردی باشد.
البته اگر my.telegram.org برای شما بدون مشکل کار میکند، روش رسمی و معمول همچنان استفاده از بخش API development tools است.
API ID با Bot Token چه فرقی دارد؟
این دو مورد را نباید با هم اشتباه گرفت.
- API ID و API Hash: مربوط به اپلیکیشن شما هستند و در پروژههایی که از Telegram API استفاده میکنند کاربرد دارند.
- Bot Token: توکن ربات است که معمولاً از BotFather دریافت میشود.
مثلاً ممکن است در یک پروژه از شما هر سه مورد خواسته شود؛ API ID، API Hash و Bot Token. هرکدام کاربرد خودش را دارد.
یک نکته مهم درباره API Hash
API Hash را مثل یک اطلاعات معمولی در نظر نگیرید. بهتر است آن را داخل کدهای عمومی، گیتهاب یا کانالهای تلگرامی منتشر نکنید.
همچنین برای دریافت API، کد ورود تلگرام یا رمز دو مرحلهای خود را در اختیار افراد دیگر قرار ندهید. اگر از یک ابزار یا ربات استفاده میکنید، قبل از وارد کردن هر اطلاعاتی مطمئن شوید دقیقاً چه چیزی از شما میخواهد.
جمعبندی
برای ساخت API ID و API Hash تلگرام معمولاً باید از طریق my.telegram.org و بخش API development tools اقدام کنید. اما اگر این قسمت برای شما خطا میدهد، میتوانید ابتدا وجود API قبلی را بررسی کنید و در صورت نیاز ApiHashGeneratorBot را هم امتحان کنید.
اگر برای ساخت ربات، یوزربات یا پروژههای برنامهنویسی تلگرام به API ID و API Hash نیاز دارید، بهتر است این اطلاعات را با دقت نگهداری کنید و در اختیار افراد یا سایتهای ناشناس قرار ندهید.
