tdlight/example/web/tdweb/README.md
levlam ec849f86b2 tdweb: prettify documentation.
GitOrigin-RevId: f61800e92f2df4269d28921592b3ec4bd6e36579
2019-04-29 20:06:18 +03:00

2.1 KiB

tdweb - TDLib in a browser

TDLib is a library for building Telegram clients. tdweb is a convenient wrapper for TDLib in a browser which controls TDLib instance creation, handles interaction with TDLib and manages a filesystem for persistent TDLib data.

For interaction with TDLib you need to create an instance of the class TdClient, providing a handler for incoming updates and other options if needed. Once this is done, you can send queries to the TDLib instance using the method TdClient.send which returns a Promise object representing the result of the query.

See Getting Started for a description of basic TDLib concepts and a short introduction to TDLib usage.

See the td_api.tl scheme or the automatically generated HTML documentation for a list of all available TDLib methods and classes. The JSON representation of TDLib API objects is straightforward: all API objects are represented as JSON objects with the same keys as the API object field names in the td_api.tl scheme. Note that in the automatically generated Ñ++ documentation all fields have an additional terminating underscore which shouldn't be used in the JSON interface. The object type name is stored in the special field '@type' which is optional in places where type is uniquely determined by the context. Fields of Bool type are stored as Boolean, fields of int32, int53 and double types are stored as Number, fields of int64 and string types are stored as String, fields of bytes type are base64 encoded and then stored as String, fields of vector type are stored as Array. You can also add the field '@extra' to any query to TDLib and the response will contain the field '@extra' with exactly the same value.