Telegram Bot API Proxy

A Cloudflare Worker that translates header-based auth into Telegram's token-in-URL format.

Overview

This proxy lets any API client that uses standard Authorization headers (like PromptQL) communicate with the Telegram Bot API seamlessly. Your bot token never appears in the URL.

Authentication

Pass your bot token in the Authorization header:

Authorization: Bearer <bot_token>

The token format is 123456789:ABCdefGHI-jklMNOpqrSTUvwxYZ (the one you get from @BotFather).

Base URL

https://tg.paritoshraj.com

Endpoints

Bot Info

Messages

Updates

Chat Management

File Downloads

File Uploads (via Base64)

Examples

cURL

# Get bot info
curl -H "Authorization: Bearer YOUR_TOKEN" https://tg.paritoshraj.com/getMe

# Send a message
curl -X POST https://tg.paritoshraj.com/sendMessage \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"chat_id": 123456, "text": "Hello from the proxy!"}'

# Get updates
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://tg.paritoshraj.com/getUpdates?offset=0&limit=10"

# Download a file
curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://tg.paritoshraj.com/file/photos/file_123.jpg -o photo.jpg

File Upload (base64 in JSON)

# Send a document using base64-encoded content
curl -X POST https://tg.paritoshraj.com/sendDocument \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": 123456,
    "document": "data:text/vcard;base64,QkVHSU4OlZDQVJE...",
    "filename": "contacts.vcf",
    "caption": "Here are the contacts!"
  }'

JavaScript (fetch)

const TOKEN = "123456789:ABCdef...";

const res = await fetch("https://tg.paritoshraj.com/sendMessage", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    chat_id: 123456,
    text: "Hello!",
  }),
});

const data = await res.json();
console.log(data);

Python (requests)

import requests

TOKEN = "123456789:ABCdef..."
headers = {"Authorization": f"Bearer {TOKEN}"}

# Get bot info
r = requests.get("https://tg.paritoshraj.com/getMe", headers=headers)
print(r.json())

# Send message
r = requests.post("https://tg.paritoshraj.com/sendMessage", headers=headers, json={
    "chat_id": 123456,
    "text": "Hello from Python!"
})
print(r.json())

PromptQL Configuration

Error Responses