File
این شی نشان‌دهنده یک فایل آماده دانلود است. این فایل را می‌توان از طریق لینک https://tapi.bale.ai/file/bot<token>/<file_path> دانلود کرد.
📝 اسکیمای داده
| فیلد | نوع | توضیحات |
|---|---|---|
file_id | string | شناسه این فایل که می‌توان برای دانلود یا استفاده مجدد از فایل به کار برد |
file_unique_id | string | شناسه منحصربه‌فرد این فایل که فرض می‌شود در طول زمان و برای بازوهای مختلف یکسان است. نمی‌توان آن را برای دانلود یا استفاده مجدد از فایل به کار برد. |
file_size | Integer | اختیاری. حجم فایل با واحد بایت. می‌تواند بیشتر از ۲^۳۱ باشد و برخی زبان‌های برنامه‌نویسی ممکن است در تفسیر آن با مشکل روبه‌رو شوند. اما این فیلد حداکثر ۵۲ بیت با ارزش اهمیت دارد و فرمت ۶۴ بیتی علامت‌دار عدد صحیح یا عدد اعشاری ۶۴ بیتی برای ذخیره‌سازی آن مناسب است. |
file_path | string | اختیاری. مسیر فایل. از آدرس https://tapi.bale.ai/file/bot<token>/<file_path> برای دریافت فایل استفاده کنید. |
⚙️ متد‌های دریافت
getFileId()
شناسه file_id فایل را بازیابی می‌کند.
$fileFileId = $fileObject->getFileId();
getFileUniqueId()
شناسه منحصر به فرد file_unique_id فایل را بازیابی می‌کند.
$fileFileUniqueId = $fileObject->getFileUniqueId();
getFileSize()
حجم file_size فایل را بازیابی می‌کند.
$fileFileSize = $fileObject->getFileSize();
getFilePath()
مسیر file_path فایل را بازیابی می‌کند.
$fileFilePath = $fileObject->getFilePath();
➕ بیشتر
نکته
برای اطلاعات بیشتر، به مستندات رسمی بله مراجعه کنید.