Documentation Complète

Documentation API

Tous les endpoints disponibles pour intégrer TheendMail dans vos applications. Simple, rapide et sécurisé.

Base URL

http://theend.lat:2424

Header: X-API-Key

Endpoints

POST /create

Crée une nouvelle adresse email associée ÂÂ votre compte.

2 crédits

cURL

curl -X POST "http://theend.lat:2424/create?username=monpseudo" \
     -H "X-API-Key:VOTRE_CLE_API"

Paramètres

username

string

Le nom d'utilisateur pour l'adresse email (ex: monpseudo@theend.lat)

Requis

username

string

Si vous souhaitez creer un mail aleatoire, utilisez uniquement https://theend.lat:2424/create sans ajouter ?username=monpseudo

facultatif

GET /emails/{username}

Récupère la liste de tous les emails reçus pour un utilisateur spécifique.

1 crédit

cURL

curl -X GET "http://theend.lat:2424/emails/monpseudo" \
     -H "X-API-Key:VOTRE_CLE_API"

Paramètres

username

string (path)

Le nom d'utilisateur dont vous voulez récupérer les emails

Requis

GET /emails/{username}/{mail_filename}

Récupère le contenu complet d'un email spécifique.

1 crédit

cURL

curl -X GET "http://theend.lat:2424/emails/monpseudo/nom_du_mail" \
     -H "X-API-Key:VOTRE_CLE_API"

Paramètres

username

string (path)

Le nom d'utilisateur propriétaire de l'email

Requis

mail_filename

string (path)

il faut le nom du fichier du mail a recupere

Requis

DELETE /emails/{username}

Supprime un utilisateur et tous ses emails associés de manière permanente.

0 crédit

cURL

curl -X DELETE "http://theend.lat:2424/emails/monpseudo" \
     -H "X-API-Key:VOTRE_CLE_API"

Paramètres

username

string (path)

Il faut que le mail vienne de la meme key par la quelle il a etais creer pour le supprimer

Requis

Exemples de code

Python

Créer un email avec Python.

Python

import requests

url = "http://theend.lat:2424/create"  # si vous le souhaitez, vous pouvez ajouter ?username=monpseudo
headers = {"X-API-Key": "VOTRE_CLE_API"}

response = requests.post(url, headers=headers)
print(response.json())

Créer un email avec JavaScript (fetch).

JavaScript

fetch("http://theend.lat:2424/create", {    # si vous le souhaitez, vous pouvez ajouter ?username=monpseudo
    method: "POST",
    headers: { "X-API-Key": "VOTRE_CLE_API" }
})
.then(res => res.json())
.then(data => console.log(data))
.catch(err => console.error(err))

C++

Créer un email avec C++ (lib cURL).

C++

#include <curl/curl.h>
#include <iostream>

int main() {
    CURL *curl = curl_easy_init();
    if(curl) {
        curl_easy_setopt(curl, CURLOPT_URL, "http://theend.lat:2424/create");  # si vous le souhaitez, vous pouvez ajouter ?username=monpseudo
        struct curl_slist *headers = NULL;
        headers = curl_slist_append(headers, "X-API-Key: VOTRE_CLE_API");
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        CURLcode res = curl_easy_perform(curl);
        if(res != CURLE_OK)
            std::cerr << curl_easy_strerror(res) << std::endl;
        curl_easy_cleanup(curl);
    }
    return 0;
}