Telegram Antispam API
Blazingly fast spam classification API built using Rocket Web Framework.
Notes
- The classifier works in aggressive mode, it can sometimes classify non-spam messages/emails as spam (when the input is too small)
- The dataset provided may contain some NSFW texts or personal info, it's not thoroughly checked.
- I've included a docker-based example, but you can run it without docker as well.
profanityin response is only there to maintain backwards compatibility for ARQ users, it always returnsfalse
Installation:
I would suggest using docker compose for this, but it's upto you!
With Docker compose
$ git clone https://github.com/thehamkercat/telegram-antispam-rs
$ cd telegram-antispam-rs
$ docker-compose build
$ docker-compose up
With Cargo
$ git clone https://github.com/thehamkercat/telegram-antispam-rs
$ cd telegram-antispam-rs
$ cargo run --release
Endpoints:
POST /spam_check HTTP/1.1
Host: localhost:8000
Content-Type: application/json
{
"text": "subscribe to my youtube channel"
}
HTTP/1.1 200 OK
content-length: 59
content-type: application/json
{
"spam": 99,
"ham": 1,
"is_spam": true,
"profanity": false,
"spam_probability": 99
}
A Go port for the same API can be found here
Usage examples:
Python
import requests
url = "http://localhost:8000/spam_check"
data = {"text": "subscribe to my youtube channel"}
result = requests.post(url, json=data).json()
print("Is spam:", result["is_spam"])
print("Spam probability:", result["spam_probability"])
Go
package main
import (
"bytes"
"encoding/json"
"net/http"
)
func main() {
url := "http://localhost:8000/spam_check"
data := map[string]string{"text": "subscribe to my youtube channel"}
jsonData, err := json.Marshal(data)
if err != nil {
panic(err)
}
req, err := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
// Do something with the response if needed
}
Rust
use std::collections::HashMap;
use serde::{Deserialize, Serialize};
#[derive(Serialize, Deserialize, Debug)]
struct Resp {
spam: u8,
ham: u8,
is_spam: bool,
spam_probability: u8,
profanity: bool
}
#[tokio::main]
async fn main(){
let client = reqwest::Client::new();
let mut map = HashMap::new();
map.insert("text", "Hello please subscribe to my youtube channel!");
let res = client
.post("http://localhost:8000/spam_check")
.json(&map)
.send()
.await
.unwrap();
let text_response = res.text().await.unwrap();
let json: Result<Resp, _> = serde_json::from_str(text_response.as_str());
if json.is_ok() {
println!("{:?}", json.unwrap());
}
}
// [dependencies]
// reqwest = { version = "0.11", features = ["json"] }
// serde = {version = "1.0.160", features = ["derive"]}
// serde_json = "1.0.96"
// tokio = { version = "1", features = ["full"] }
1 Sep 16, 2022
15 Dec 1, 2023
2 May 17, 2022
14 Sep 10, 2022
5 Jan 30, 2023
85 Jan 5, 2023
82 Dec 14, 2022
109 May 7, 2022
13 Dec 16, 2022
4 May 23, 2022
197 Dec 18, 2022
6 Dec 30, 2022
2 Oct 14, 2022
6 Nov 17, 2022
472 Jan 7, 2023
21 Jan 1, 2023
45 Dec 17, 2022
4 Nov 24, 2023
2 Feb 27, 2022