API docs by Redocly

Telegram OTP Auth Service API (1.0)

Download OpenAPI specification:

Auth service for Telegram-based OTP verification flow.

auth

JWKS public keys

Returns the JSON Web Key Set containing the public key for proof_token verification.

Responses

Response samples

Content type
application/json
{ }

Initiate OTP verification

Start a new OTP verification flow for a Telegram user.

Authorizations:
BearerAuth
Request Body schema: application/json
required

Init request

callback_state_code
string
callback_uri
string
callback_uri_auth_token
string
client_id
string
expires_in_seconds
integer
flow_title_postfix
string
flow_title_prefix
string
redirect_uri
string
telegram_user_id
string

Responses

Request samples

Content type
application/json
{
  • "callback_state_code": "string",
  • "callback_uri": "string",
  • "callback_uri_auth_token": "string",
  • "client_id": "string",
  • "expires_in_seconds": 0,
  • "flow_title_postfix": "string",
  • "flow_title_prefix": "string",
  • "redirect_uri": "string",
  • "telegram_user_id": "string"
}

Response samples

Content type
application/json
{
  • "auth_url": "string",
  • "expires_at": "string",
  • "expires_in_seconds": 0
}