HITL

Create chat ID discovery token

Generate a Telegram deeplink for auto-detecting a user's chat ID. The user clicks the link, messages the bot, and the chat ID is captured.

post/api/v1/hitl/chat-id-discovery

Request

  • Base URL: https://api.proof.holdings
  • URL: https://api.proof.holdings/api/v1/hitl/chat-id-discovery
  • Auth: HTTP bearer

Response

Discovery token created

tokenstring required
deep_linkstring uri required
qr_codestring required

QR code data URL for the deep link

qr_textstring required

UTF-8 text representation of the QR code for terminal/agent display

expires_ininteger required

Example response

{
  "token": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
  "deep_link": "https://t.me/proof_holdings_bot?start=chatid_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
  "qr_code": "data:image/png;base64,...",
  "expires_in": 600
}

Changes

No recorded changes to this operation across all 1 revision of this API.