Thư viện media

Để bot gửi hình ảnh và tệp, chúng cần được lưu trữ ở đâu đó. GetMyBot có thư viện media riêng: bạn tải lên tệp một lần, và nền tảng tự chèn nó vào tin nhắn. Thư viện deduplication các tệp giống nhau và thuộc về tính năng premium; cho tình huống cơ bản có tùy chọn tải lên miễn phí qua Telegram chat.

Kho lưu trữ riêng

Tệp đã tải lên được lưu trong kho lưu trữ của nền tảng và nhận định danh media. Trong khối tin nhắn "Ảnh" hoặc "Tệp" có thể tham chiếu đến định danh này — khi gửi, nền tảng sẽ tự chèn tệp cần thiết. Tải lên: POST /api/bots/{id}/media, đọc để xem trước: GET /api/bots/{id}/media/{mediaID}.

Deduplication theo nội dung

Mỗi tệp được nhận dạng bằng sha256 hash của nội dung. Nếu bạn tải lên cùng một tệp lần thứ hai, nền tảng sẽ không tạo bản sao mà trả về liên kết đến object đã lưu. Như vậy, các hình ảnh giống nhau không chiếm chỗ hai lần, còn định danh vẫn ổn định.

Truy cập premium

Thư viện media là tính năng premium (image_storage). Nó có sẵn trên gói cước trả phí bao gồm nó; không có đăng ký active, việc tải lên thư viện sẽ trả về lỗi 402 (yêu cầu thanh toán). Xem trước các tệp đã lưu hoạt động không có giới hạn.

Kích thước một tệp khi tải lên thư viện giới hạn ở 2 MiB.

Tải lên qua Telegram chat (không cần premium)

Nếu thư viện premium không có sẵn, có cách miễn phí: sink-upload — POST /api/bots/{id}/chats/{chatID}/sink-upload. Tệp được gửi qua Telegram chat được chỉ định, và phản hồi trả về file_id Telegram có thể dùng trong tin nhắn của bot. Cách này có sẵn cho tất cả mà không cần premium; giới hạn kích thước — cũng là 2 MiB.

Nên dùng gì

  • Thường xuyên tái sử dụng cùng một hình ảnh và muốn deduplication cùng xem trước — thư viện media (premium).
  • Cần nhanh chóng lấy file_id mà không cần đăng ký — sink-upload qua chat dịch vụ.

Tiếp theo