《开源精选》是我们分享Github、Gitee等开源社区中优质项目的栏目，包括技术、学习、实用与各种有趣的内容。本期推荐的Telegram是一款专注于速度和安全性的消息传递应用程序,它超快、简单且免费。
我们欢迎所有开发者使用我们的 API 和源代码在我们的平台上创建应用程序。
- 为您的应用程序获取您自己的 api_id。
- 请不要为您的应用使用 Telegram 名称——或确保您的用户明白它是非官方的。
- 请不要使用我们的标准徽标（蓝色圆圈中的白纸平面）作为您应用的徽标。
- 请阅读我们的安全指南，并妥善保管您用户的数据和隐私。
- 请记住也发布您的代码以遵守许可证。
入门
创建您的电报应用程序
我们欢迎所有开发者使用我们的API和源代码在我们的平台上免费创建类似 Telegram 的消息应用程序。
获取 api_id
为了获取API id并使用 Telegram API 开发您自己的应用程序，您需要执行以下操作：
- 使用任何应用程序注册 Telegram。
- 登录到您的 Telegram 核心：https ://my.telegram.org 。
- 转到“API 开发工具”并填写表格。
- 您将获得基本地址以及用户授权所需的api_id和api_hash参数。
- 目前每个号码只能有一个 api_id 连接到它。
我们将向您在此过程中使用的电话号码发送重要的开发者通知，因此请使用连接到您的有效 Telegram 帐户的最新号码。
使用 api_id
在使用 MTProto Telegram API 之前，请注意所有 API 客户端库都受到严格监控以防止滥用。
如果您使用 Telegram API 进行泛滥、发送垃圾邮件、伪造订阅者和查看频道计数器，您将被永久禁止。
由于对 Telegram API 的过度滥用，所有使用非官方 Telegram API 客户端注册或登录的帐户都会被自动置于监控之下，以避免违反服务条款。
如果您没有违反服务条款，但您 的帐户在使用 API 后确实被禁止，请写信至recovery@telegram.org ，说明您打算如何使用 API，要求解除您的帐户。请注意，电子邮件由人工检查，因此将检测并禁止自动生成的电子邮件。
使用 Telegram 的开源代码
欢迎大家使用我们的开源代码。我们在代码中包含了一个示例 API id。此 API id 在服务器端受到限制，不适合发布给最终用户的应用程序 – 将其用于任何测试目的都会导致您的用户出现 API_ID_PUBLISHED_FLOOD 错误。在发布应用程序之前，您必须获取自己的 API id 。
用户授权
授权与客户端的加密密钥标识符相关联：auth_key_id。授权后无需将其他参数传递给方法。
发送验证码
示例实现：用于 android 的电报，tdlib。
要显示格式良好且经过验证的电话号码字段，可以使用help.getCountriesList方法获取help.countriesList构造函数。 然后按照此处所述使用help.countriesList配置。
然后，使用auth.sendCode将包含授权码的短信发送到用户的手机。但是，如果使用注销令牌，情况并非总是如此：
注销令牌
在启用 2FA 的先前授权会话上调用auth.logOutfuture_auth_token时，服务器可能会返回 a ，它应该存储在本地数据库中。在任何时候，注销令牌数据库都应包含最多 20 个令牌：在添加新令牌时驱逐旧令牌。调用auth.sendCode时，应将数据库中存在的所有注销令牌提供给codeSettings.logout_tokens.如果任何注销令牌与我们尝试登录的帐户匹配并且令牌尚未过期，则 auth.sendCode将直接返回一个SESSION_PASSWORD_NEEDEDRPC 错误，直接要求用户输入 2FA 密码，而不发送任何授权码。
否则，系统将使用以下逻辑发送授权码：
代码类型
系统会自动选择授权码的发送方式；代码可以通过多种可能的方式到达：
- 注销令牌
- 电报代码
- 短信代码
- 电话：合成语音会告诉用户输入哪个验证码。
- Flash电话：代码将通过Flash电话发送，该电话将立即关闭。在最后一种情况下，电话代码将是电话号码本身，只需确保电话号码与指定的模式匹配（请参阅auth.sentCodeTypeFlashCall）。
- 未接电话：代码将通过闪电话发送，将立即关闭。呼叫的电话号码的最后一位是必须由用户手动输入的代码。
auth.sendCode方法还具有用于启用/禁用使用紧急呼叫和未接呼叫的参数，并允许传递将包含在已发送 SMS 中的 SMS 令牌。例如，在较新版本的 android 中需要后者，才能使用android SMS 接收器 API。
通过二维码登录
导出登录令牌
首先，要登录现有 Telegram 帐户的应用程序必须调用auth.exportLoginToken 。该方法将返回一个auth.loginToken构造函数，其中包含二进制登录token和到期日期（通常为 30 秒）。
登录token必须使用base64url进行编码，嵌入在tg://login?token=base64encodedtokenURL 中并以QR 码的形式显示给用户。当前二维码到期后，必须调用auth.exportLoginToken方法，并自动生成新的二维码。
接受登录令牌
为了登录，必须使用auth.acceptLoginToken由已登录的 Telegram 应用程序扫描并接受 QR 码。在方法中使用令牌之前，必须从tg://loginURI 中提取令牌并进行 base64url 解码。
该方法可能返回的错误是：
- 400 -AUTH_TOKEN_INVALID提供了无效的授权令牌
- 400 – AUTH_TOKEN_EXPIRED，提供的授权令牌已过期，必须重新扫描更新的二维码
- 400 -AUTH_TOKEN_ALREADY_ACCEPTED授权令牌已被使用
该方法将返回一个授权对象，其中包含有关我们刚刚授权的应用程序和会话的信息。
确认（导入）登录令牌
登录的应用程序调用auth.acceptLoginToken并接受登录令牌后，尝试登录的应用程序将收到updateLoginToken更新，这将触发对auth.exportLoginToken方法 的第二次调用。
然后，第二次调用应该返回一个auth.loginTokenSuccess构造函数，指示登录成功，本质上允许与 API 进行进一步的授权交互。
但是，如果两个应用程序之间存在 DC 不匹配，则返回auth.loginTokenMigrateTo，尝试登录的应用程序应通过调用指定的auth.importLoginTokentoken来响应指定的 DC。
这个调用最终应该返回一个auth.loginTokenSuccess构造函数。
消息草稿
消息草稿
Telegram 中的消息草稿允许在设备之间同步输入到消息字段中的文本。
草稿
草稿由DraftMessage构造函数表示。在编写要发送给特定对等方的消息时，应使用特定对等草稿的参数作为默认值（在媒体的情况下，仍应使用相同的草稿作为基础，消息将成为标题）。如果用户在发送消息之前退出应用程序，则消息应保存为草稿：
保存草稿
可以使用messages.saveDraft方法保存草稿。
下载草稿
新草稿会通过updateDraftMessage更新自动发送到所有设备。
通过 API 获取的对话对象也包含与对话相关的草稿。
开源协议：GPL-2.0 license
开源地址：https://github.com/DrKLO/Telegram
