68 lines
2.6 KiB
ReStructuredText
68 lines
2.6 KiB
ReStructuredText
|
Authorization
|
||
|
|
=============
|
||
|
|
|
||
|
|
Once a `project is set up`_, you will still have to follow a few steps before you can actually use Pyrogram to make
|
||
|
|
API calls. This section provides all the information you need in order to authorize yourself as user or a bot.
|
||
|
|
|
||
|
|
User Authorization
|
||
|
|
------------------
|
||
|
|
|
||
|
|
In order to use the API, Telegram requires that users be authorized via their phone numbers.
|
||
|
|
Pyrogram automatically manages this access, all you need to do is create an instance of the
|
||
|
|
:class:`Client <pyrogram.Client>` class by passing to it a ``session_name`` of your choice (e.g.: "my_account") and call
|
||
|
|
the :meth:`run() <pyrogram.Client.run>` method:
|
||
|
|
|
||
|
|
.. code-block:: python
|
||
|
|
|
||
|
|
from pyrogram import Client
|
||
|
|
|
||
|
|
app = Client("my_account")
|
||
|
|
app.run()
|
||
|
|
|
||
|
|
This starts an interactive shell asking you to input your **phone number** (including your `Country Code`_) and the
|
||
|
|
**phone code** you will receive in your devices that are already authorized or via SMS:
|
||
|
|
|
||
|
|
.. code-block:: text
|
||
|
|
|
||
|
|
Enter phone number: +39**********
|
||
|
|
Is "+39**********" correct? (y/n): y
|
||
|
|
Enter phone code: 32768
|
||
|
|
Logged in successfully as Dan
|
||
|
|
|
||
|
|
After successfully authorizing yourself, a new file called ``my_account.session`` will be created allowing Pyrogram to
|
||
|
|
execute API calls with your identity. This file will be loaded again when you restart your app, and as long as you
|
||
|
|
keep the session alive, Pyrogram won't ask you again to enter your phone number.
|
||
|
|
|
||
|
|
.. important::
|
||
|
|
|
||
|
|
Your ``*.session`` files are personal and must be kept secret.
|
||
|
|
|
||
|
|
.. note::
|
||
|
|
|
||
|
|
The code above does nothing except asking for credentials and keeping the client online, hit ``CTRL+C`` now to stop
|
||
|
|
your application and keep reading.
|
||
|
|
|
||
|
|
Bot Authorization
|
||
|
|
-----------------
|
||
|
|
|
||
|
|
Bots are a special kind of users that are authorized via their tokens (instead of phone numbers), which are created by
|
||
|
|
the `Bot Father`_. Bot tokens replace the users' phone numbers only — you still need to
|
||
|
|
`configure a Telegram API key <setup.html#configuration>`_ with Pyrogram, even when using bots.
|
||
|
|
|
||
|
|
The authorization process is automatically managed. All you need to do is choose a ``session_name`` (can be anything,
|
||
|
|
usually your bot username) and pass your bot token using the ``bot_token`` parameter. The session file will be named
|
||
|
|
after the session name, which will be ``pyrogrambot.session`` for the example below.
|
||
|
|
|
||
|
|
.. code-block:: python
|
||
|
|
|
||
|
|
from pyrogram import Client
|
||
|
|
|
||
|
|
app = Client(
|
||
|
|
"my_bot",
|
||
|
|
bot_token="123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11"
|
||
|
|
)
|
||
|
|
app.run()
|
||
|
|
|
||
|
|
.. _project is set up: setup.html
|
||
|
|
.. _Country Code: https://en.wikipedia.org/wiki/List_of_country_calling_codes
|
||
|
|
.. _Bot Father: https://t.me/botfather
|