File
نوع دادهاین شیء یک فایل آمادهٔ دانلود را نشان میدهد. فایل را میتوان از طریق لینک https://api.telegram.org/file/bot<token>/<file_path> دانلود کرد. تضمین میشود لینک دستکم ۱ ساعت معتبر باشد. وقتی لینک منقضی شد، میتوان با فراخوانی getFile لینک جدیدی خواست.
فیلدها
| نام | نوع | توضیحات |
|---|---|---|
| file_id | String | شناسهٔ این فایل که برای دانلود یا استفادهٔ دوبارهٔ فایل کاربرد دارد. |
| file_unique_id | String | شناسهٔ یکتای این فایل که قرار است در طول زمان و برای رباتهای مختلف یکسان بماند. برای دانلود یا استفادهٔ دوبارهٔ فایل قابل استفاده نیست. |
| file_size | Integer | اختیاری. حجم فایل به بایت. میتواند بزرگتر از 2^31 باشد و بعضی زبانهای برنامهنویسی در تفسیر آن دچار مشکل یا خطای بیصدا شوند؛ اما حداکثر ۵۲ بیت معنادار دارد، بنابراین عدد صحیح ۶۴ بیتی علامتدار یا اعشاری با دقت دوگانه برای نگهداری آن امن است. |
| file_path | String | اختیاری. مسیر فایل. برای گرفتن فایل از https://api.telegram.org/file/bot<token>/<file_path> استفاده کنید. |