telegram-gateway-verification 0.1.1

Python client for Telegram Gateway verification API

telegram-gateway-verification

Python-библиотека для отправки кодов верификации через Telegram Gateway API.

Возможности

• Отправка кода верификации (sendVerificationMessage)
• Проверка возможности отправки (checkSendAbility)
• Проверка статуса верификации (checkVerificationStatus)
• Отмена отправленного запроса (revokeVerificationMessage)
• Проверка подписи webhook callback (X-Request-Timestamp, X-Request-Signature)

Установка

pip install telegram-gateway-verification

Установка для локальной разработки:

pip install -e '.[dev]'

Быстрый старт

import os

from telegram_gateway_verification import TelegramGatewayClient

client = TelegramGatewayClient(
    api_token=os.environ["TELEGRAM_GATEWAY_TOKEN"],  #https://gateway.telegram.org/account/api
)

status = client.send_verification_message(
    phone_number="[phone]",
    code_length=6,
    ttl=60,
    callback_url="https://example.com/webhooks/telegram-gateway",
)

print(status.request_id)

API

send_verification_message(...) -> RequestStatus
check_send_ability(phone_number=...) -> RequestStatus
check_verification_status(request_id=..., code=...) -> RequestStatus
revoke_verification_message(request_id=...) -> bool

Проверка подписи callback

from telegram_gateway_verification import verify_callback_signature

ok = verify_callback_signature(
    api_token=os.environ["TELEGRAM_GATEWAY_TOKEN"],
    timestamp_header=request.headers["X-Request-Timestamp"],
    signature_header=request.headers["X-Request-Signature"],
    raw_body=request.get_data(),  # raw bytes тела запроса
)

if not ok:
    return "invalid signature", 403

Важные детали

• phone_number должен быть в формате E.164 (например, [phone]).
• ttl для sendVerificationMessage: от 30 до 3600 секунд.
• Если API отвечает {"ok": false, ...}, библиотека бросает TelegramGatewayAPIError.

Полезные ссылки

• Telegram Gateway API: https://core.telegram.org/gateway/api
• Telegram Gateway Overview: https://core.telegram.org/gateway
• Verification Tutorial: https://core.telegram.org/gateway/verification-tutorial