Retour
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éthodeEndpointDescription
GET/account/domainsLister les domaines
POST/account/domainAjouter un domaine
GET/account/domain/{uuid}Détails d'un domaine
DELETE/account/domain/{uuid}Supprimer un domaine

Boîtes mail

MéthodeEndpointDescription
GET/account/domain/{d}/emailsLister les boîtes
POST/account/domain/{d}/emailCréer une boîte
DELETE/account/domain/{d}/email/{uuid}Supprimer une boîte

Listes blanches / noires

MéthodeEndpointDescription
GET.../{e}/wblistLister les entrées
POST.../{e}/wblistAjouter une entrée
DELETE.../{e}/wblist/{id}Supprimer une entrée

Boîte de réception

MéthodeEndpointDescription
GET.../{e}/inbox/statsKPIs de la boîte
GET.../{e}/inbox/pendingEmails en attente
POST.../{e}/inbox/{m}/approveApprouver un email
POST.../{e}/inbox/{m}/rejectRejeter un email

Quotas

MéthodeEndpointDescription
GET/account/limitsLimites 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"
  }
}