NAME

Net::API::Telegram::ChatPhoto - A chat photo

SYNOPSIS

my $msg = Net::API::Telegram::ChatPhoto->new( %data ) || 
die( Net::API::Telegram::ChatPhoto->error, "\n" );

DESCRIPTION

Net::API::Telegram::ChatPhoto is a Telegram Message Object as defined here https://core.telegram.org/bots/api#chatphoto

This module has been automatically generated from Telegram API documentation by the script scripts/telegram-doc2perl-methods.pl.

METHODS

new( {INIT HASH REF}, %PARAMETERS )

new() will create a new object for the package, pass any argument it might receive to the special standard routine init that must exist. Then it returns what returns init().

The valid parameters are as follow. Methods available here are also parameters to the new method.

  • verbose

  • debug

big_file_id( String )

File identifier of big (640x640) chat photo. This file_id can be used only for photo download and only for as long as the photo is not changed.

download( file_id, [ file extension ] )

Given a file id like small_file_id or big_file_id, this will call the getFile() method from the parent Net::API::Telegram package and receive a Net::API::Telegram::File object in return, which contains a file path valid for only one hour according to Telegram api here https://core.telegram.org/bots/api#getfile. With this file path, this download method will issue a http get request and retrieve the file and save it locally in a temproary file generated by File::Temp. If an extension is provided, it will be appended to the temproary file name such as myfile.jpg otherwise the extension will be gussed from the mime type returned by the Telegram http server, if any.

This method returns undef() on error and sets a Net::API::Telegram::Error or, on success, returns a hash reference with the following properties:

filepath

The full path to the temporary file

mime

The mime type returned by the server.

response

The HTTP::Response

size

The size in bytes of the file fetched

download( )
small_file_id( String )

File identifier of small (160x160) chat photo. This file_id can be used only for photo download and only for as long as the photo is not changed.

COPYRIGHT

Copyright (c) 2000-2019 DEGUEST Pte. Ltd.

AUTHOR

Jacques Deguest <jack@deguest.jp>

SEE ALSO

Net::API::Telegram

COPYRIGHT & LICENSE

Copyright (c) 2018-2019 DEGUEST Pte. Ltd.

You can use, copy, modify and redistribute this package and associated files under the same terms as Perl itself.