Async PHP client/server API for the telegram MTProto protocol https://docs.madelineproto.xyz
Go to file
2015-03-13 19:21:49 +03:00
tests 3-byte error in large string send fixed. 2015-03-13 16:58:27 +03:00
.gitignore gitignore fix for jetbrains ide 2015-03-12 00:46:02 +09:00
mtproto.py next step - to decrypt answer with AES 2015-03-13 19:21:49 +03:00
prime.py Trying to go through step 4. 2015-03-12 19:29:56 +03:00
README.md Update README.md 2015-03-13 15:48:33 +03:00
testing.py next step - to decrypt answer with AES 2015-03-13 19:21:49 +03:00
TL_schema.JSON TL Schema moved to JSON mode. 2015-03-11 19:58:26 +03:00

Join the chat at https://gitter.im/griganton/telepy

About this repo

This is Telegram API for python. Main aim is to implement MTProto protocol Telegram API on pure Python (not wrapped CLI)

Plan

Useful start points to join

Detailed description of API and protocol can be found here:

API registration is needed to be done by yourself at http://my.telegram.org Follow Structure - Credentials for provide it your API information.

Structure

  • tests
  • Serialization and SHA.py
  • mtproto.py
  • testing.py
  • prime.py
  • credentials
  • rsa.pub

Credentials

Repo doesn't contain any credentials to connect Telegram servers. You can get yours from http://my.telegram.org

You should place 2 files in the root of your repo:

  • credentials
  • rsa.pub

Config example for "credentials" file:

[App data]
api_id: 12345
api_hash: 1234567890abcdef1234567890abcdef
ip_address: 112.134.156.178
port: 443

rsa.pub contains your RSA key.

mtproto.py

Contains functions to work with MTproto protocol:

  • TL schema parsing
  • serializing and deserializing
  • manage connections to server
  • send and receive messages

testing.py

testing.py is used to test functionality of modules. Now it makes steps from https://core.telegram.org/mtproto/samples-auth_key:

  • sends PQ request to server
  • parses the result
  • factorizes PQ

prime.py

prime.py is used in PQ factorization. It has been copied from https://stackoverflow.com/questions/4643647/fast-prime-factorization-module

TL schema

We use JSON format TL Shema. TL Schema file contains information about objects and methods, it is located in TL_schema.JSON file in the root of repo. It is fully equivalent to JSON TL Schema from https://core.telegram.org/schema/mtproto-json