mirror of
https://github.com/TeamPGM/pyrogram.git
synced 2024-12-01 01:57:51 +00:00
93 lines
3.2 KiB
ReStructuredText
93 lines
3.2 KiB
ReStructuredText
Authorization
|
|
=============
|
|
|
|
Once a :doc:`project is set up <setup>`, 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 bot.
|
|
|
|
.. contents:: Contents
|
|
:backlinks: none
|
|
:depth: 1
|
|
:local:
|
|
|
|
-----
|
|
|
|
User Authorization
|
|
------------------
|
|
|
|
In order to use the API, Telegram requires that users be authorized via their phone numbers.
|
|
Pyrogram automatically manages this process, all you need to do is create an instance of the
|
|
:class:`~pyrogram.Client` class by passing to it a ``name`` of your choice (e.g.: "my_account") and call
|
|
the :meth:`~pyrogram.Client.run` method:
|
|
|
|
.. code-block:: python
|
|
|
|
from pyrogram import Client
|
|
|
|
api_id = 12345
|
|
api_hash = "0123456789abcdef0123456789abcdef"
|
|
|
|
app = Client("my_account", api_id=api_id, api_hash=api_hash)
|
|
|
|
app.run()
|
|
|
|
This starts an interactive shell asking you to input your **phone number**, including your `Country Code`_ (the plus
|
|
``+`` and minus ``-`` symbols can be omitted) and the **phone code** you will receive in your devices that are already
|
|
authorized or via SMS:
|
|
|
|
.. code-block:: text
|
|
|
|
Enter phone number: +1-123-456-7890
|
|
Is "+1-123-456-7890" correct? (y/n): y
|
|
Enter phone code: 12345
|
|
Logged in successfully
|
|
|
|
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 is personal and will be loaded again when you restart your app.
|
|
You can now remove the api_id and api_hash values from the code as they are not needed anymore.
|
|
|
|
.. note::
|
|
|
|
The code above does nothing except asking for credentials and keeping the client online, hit :guilabel:`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
|
|
:doc:`configure a Telegram API key <../start/setup>` with Pyrogram, even when using bots.
|
|
|
|
The authorization process is automatically managed. All you need to do is choose a ``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 ``my_bot.session`` for the example below.
|
|
|
|
.. code-block:: python
|
|
|
|
from pyrogram import Client
|
|
|
|
api_id = 12345
|
|
api_hash = "0123456789abcdef0123456789abcdef"
|
|
bot_token = "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11"
|
|
|
|
app = Client(
|
|
"my_bot",
|
|
api_id=api_id, api_hash=api_hash,
|
|
bot_token=bot_token
|
|
)
|
|
|
|
app.run()
|
|
|
|
.. _Country Code: https://en.wikipedia.org/wiki/List_of_country_calling_codes
|
|
.. _Bot Father: https://t.me/botfather
|
|
|
|
.. note::
|
|
|
|
The API key (api_id and api_hash) and the bot_token are not required anymore after a successful authorization.
|
|
This means you can now simply use the following:
|
|
|
|
.. code-block:: python
|
|
|
|
from pyrogram import Client
|
|
|
|
app = Client("my_account")
|
|
app.run() |