Telegram REST API

Prologue

Receiving notifications on your phone can be extremely beneficial, keeping you updated on important events or activities. However, sending push notifications often involves a complex process, which can be overwhelming for many users and developers. Applications like Telegram have elegantly solved this issue by introducing bots, which can send notifications directly to users. Telegram bots provide a seamless way to manage notifications, but building and maintaining these bots requires technical expertise and resources, making it a challenging task for many individuals or businesses.

To address these difficulties, we have developed a service that simplifies the entire process. With our platform, you no longer need to worry about the technical complexities of creating and maintaining a Telegram bot. Our service allows you to easily set up and start receiving notifications on your Telegram account without any hassle. Best of all, this service is completely free, enabling you to enjoy the benefits of real-time updates without the headaches of managing infrastructure or code.

Getting Started

To begin integrating with Dollarsigned’s platform, the only initial setup required is to send a message to the official Dollarsigned Telegram bot to obtain your unique access token. This token serves as your authentication key and is essential for interacting with the system. Once acquired, it allows for seamless and secure communication with the Dollarsign API, enabling you to incorporate messaging functionality directly into your application.

With your token in hand, you can start sending HTML-parsed messages through our designated API endpoint. These messages will be delivered by the bot and can be programmatically retrieved within your application environment. This straightforward integration empowers developers to embed rich, Telegram-based messaging features into their apps with minimal overhead, ensuring a smooth user experience and efficient message handling.

Examples

Python

import requests

url = 'https://dollarsigned.com/api/telegram'
data = {
    'token': 'your_token_here',
    'message': "Why don't skeletons fight each other? They don't have the guts."
}

response = requests.post(url, data=data)
print(response.status_code)
print(response.text)

Go

package main

import (
	"bytes"
	"net/http"
	"net/url"
	"fmt"
)

func main() {
	data := url.Values{}
	data.Set("token", "your_token_here")
	data.Set("message", "I asked the librarian if the library had books on paranoia. She whispered, 'They're right behind you.'")

	resp, err := http.PostForm("https://dollarsigned.com/api/telegram", data)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	fmt.Println("Status:", resp.Status)
}

Ruby

require 'net/http'
require 'uri'

uri = URI.parse("https://dollarsigned.com/api/telegram")
response = Net::HTTP.post_form(uri, {
  "token" => "your_token_here",
  "message" => "I told a joke about a bed. It hasn’t been made up yet."
})

puts response.code
puts response.body

JavaScript

const axios = require("axios");

axios
    .post("https://dollarsigned.com/api/telegram", {
        token: "your_token_here",
        message: "Why don’t eggs tell jokes? They’d crack each other up.",
    })
    .then((response) => {
        console.log(response.data);
    })
    .catch((error) => {
        console.error(error);
    });

Java

import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;

public class PostRequest {
    public static void main(String[] args) throws Exception {
        String url = "https://dollarsigned.com/api/telegram";
        String data = "token=your_token_here&message=I have a split personality,” said Tom, being Frank.";

        HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();
        conn.setRequestMethod("POST");
        conn.setDoOutput(true);

        try (OutputStream os = conn.getOutputStream()) {
            os.write(data.getBytes());
        }

        System.out.println("Response code: " + conn.getResponseCode());
    }
}

PHP

$data = [
    'token' => 'your_token_here',
    'message' => 'Did you hear about the claustrophobic astronaut? He needed a little space.'
];

$options = [
    'http' => [
        'header'  => "Content-type: application/x-www-form-urlencoded",
        'method'  => 'POST',
        'content' => http_build_query($data)
    ]
];

$context  = stream_context_create($options);
$result = file_get_contents("https://dollarsigned.com/api/telegram", false, $context);

echo $result;

Laravel

use Illuminate\Support\Facades\Http;

$response = Http::post('https://dollarsigned.com/api/telegram', [
    'token' => 'your_token_here',
    'message' => "Parallel lines have so much in common… it’s a shame they’ll never meet."
]);

dd($response->body());

CURL

curl -X POST https://dollarsigned.com/api/telegram \
     -d "token=your_token_here" \
     -d "message=I told my computer I needed a break, and now it won’t stop sending me Kit-Kats."

Bash

send_post() {
  curl -X POST https://dollarsigned.com/api/telegram \
       -d "token=$1" \
       -d "message=I would tell you a UDP joke, but you might not get it."
}

send_post "your_token_here"

Rate Limiting

Currently, we offer a free plan that allows everyone to send up to 5 requests per minute. This means you can make a maximum of 5 requests to our system every minute. If you exceed this limit, you’ll need to wait until the next minute to send more requests.

This free plan is designed to give you easy access to our service without any cost. However, if you need to make more requests within a shorter time, you may want to explore other plans that offer higher limits. These plans are designed to meet the needs of users who require more frequent interactions with our platform.