Simple API to ping a telegram bot using superbot (mtproto)
Find a file
Awiteb cffada6b3b
All checks were successful
Write changelog / write-changelog (push) Successful in 22s
Rust CI / Rust CI (push) Successful in 3m7s
chore: Initialize actions
Signed-off-by: Awiteb <a@4rs.nl>
2024-05-29 01:20:19 +03:00
.forgejo chore: Initialize actions 2024-05-29 01:20:19 +03:00
.github/workflows chore: Initialize actions 2024-05-29 01:20:19 +03:00
src chore: Upgrade dependencies and fix lint errors 2024-05-28 22:27:33 +03:00
.env.example Add .example files 2023-11-18 22:42:17 +03:00
.gitignore Add .gitignore 2023-11-18 22:42:10 +03:00
bots.txt.example First commit 2023-11-18 22:48:36 +03:00
Cargo.lock chore: Upgrade dependencies and fix lint errors 2024-05-28 22:27:33 +03:00
Cargo.toml chore: Upgrade dependencies and fix lint errors 2024-05-28 22:27:33 +03:00
CHANGELOG.md chore: Initialize the changelogs 2024-05-28 22:27:33 +03:00
cliff.toml chore: Initialize the changelogs 2024-05-28 22:27:33 +03:00
Justfile chore: Add Justfile 2024-05-28 22:27:33 +03:00
LICENSE Add the license 2023-11-18 19:40:07 +03:00
README.md Add README 2023-11-18 22:48:41 +03:00
rust-toolchain.toml chore: Add rust files 2024-05-28 22:27:33 +03:00
rustfmt.toml chore: Add rust files 2024-05-28 22:27:33 +03:00
tokens.txt.example First commit 2023-11-18 22:48:36 +03:00

TelePingBot

A simple API to ping telegram bots and returns if it's online or not. using superbot to send message to the bots (mtproto).

Why is simple?

Add your API tokens in the tokens.txt and add the bot usernames in the bots.txt and you're ready to go! No need to generate tokens or anything else.

tokens.txt file (rename tokens.txt.example to tokens.txt)

The tokens.txt file is where you put your API tokens. You can put as many as you want, but make sure to put one in each line. This is API access tokens, you need to put it in Authorization header.

Warning

Remember to keep this file safe, because anyone can use it to ping your bots. Recommended to generate the tokens with openssl rand -hex 32 or uuidgen.

bots.txt file (rename bots.txt.example to bots.txt)

The bots.txt file is where you put your bot usernames, this to make sure to ping the specifics bots only. You can put as many as you want, but make sure to put one in each line.

for example:

@BotFather
@SomeTestBot
@SomeTestBot

.env file (rename .env.example to .env)

You need to fill the variables in it.

Requirements

  • Rust (MSRV 1.68.2)
  • Cargo

Build

cargo build --release

Run

cargo run --release

Or just run the binary file in target/release/telepingbot (Not recommended because the .env file)

Endpoints

/ping/@<bot_username>

This endpoint is to ping the bot and returns if it's online or not.

Headers

  • Authorization: The API access token. e.g: Authorization: FirstToken

Response

  • 200: The bot is online.
  • 404: The bot is offline.
  • 401: The API access token is invalid.
  • 500: Internal server error. e.g: The bot username is invalid or the superbot can't send message to the bot.

Example

Note

Replace FirstToken with your API access token and @testbot with your bot username and the host and port with your host and port.

curl -v 0.0.0.0:3939/ping/@testbot -H "Authorization: FirstToken"