Technique
Documentation API
Intégrez AntiSpammeur à vos outils via notre API REST.
Authentification
L'API utilise des tokens JWT (JSON Web Tokens) pour l'authentification.
Obtenir un token
POST /auth/login
Content-Type: application/json
{
"email": "user@example.com",
"password": "votre_mot_de_passe"
}Utiliser le token
Authorization: Bearer votre_token_jwt
Le token expire après 24h. Utilisez le refresh token pour en obtenir un nouveau sans vous reconnecter.
Format des réponses
Toutes les réponses suivent le même format :
Succès
{
"success": true,
"data": { ... }
}Erreur
{
"success": false,
"error": {
"code": "error_code",
"message": "Description"
}
}Endpoints principaux
Domaines
| Méthode | Endpoint | Description |
|---|---|---|
| GET | /account/domains | Lister les domaines |
| POST | /account/domain | Ajouter un domaine |
| GET | /account/domain/{uuid} | Détails d'un domaine |
| DELETE | /account/domain/{uuid} | Supprimer un domaine |
Boîtes mail
| Méthode | Endpoint | Description |
|---|---|---|
| GET | /account/domain/{d}/emails | Lister les boîtes |
| POST | /account/domain/{d}/email | Créer une boîte |
| DELETE | /account/domain/{d}/email/{uuid} | Supprimer une boîte |
Listes blanches / noires
| Méthode | Endpoint | Description |
|---|---|---|
| GET | .../{e}/wblist | Lister les entrées |
| POST | .../{e}/wblist | Ajouter une entrée |
| DELETE | .../{e}/wblist/{id} | Supprimer une entrée |
Boîte de réception
| Méthode | Endpoint | Description |
|---|---|---|
| GET | .../{e}/inbox/stats | KPIs de la boîte |
| GET | .../{e}/inbox/pending | Emails en attente |
| POST | .../{e}/inbox/{m}/approve | Approuver un email |
| POST | .../{e}/inbox/{m}/reject | Rejeter un email |
Quotas
| Méthode | Endpoint | Description |
|---|---|---|
| GET | /account/limits | Limites et usage actuel |
Codes d'erreur
401Token manquant ou expiré 403Permission insuffisante ou quota dépassé 404Ressource non trouvée 409Conflit (ressource déjà existante) 422Données invalides 429Trop de requêtes (rate limit) 500Erreur serveur
Erreurs de quota
Quand un quota est dépassé, l'API retourne :
{
"success": false,
"error": {
"code": "quota_exceeded",
"resource": "mailbox",
"current": 50,
"max": 50,
"message": "Limite atteinte"
}
}