Règles personnalisées

Les règles personnalisées permettent de remplacer les résultats de classification pour des domaines ou patterns MX spécifiques. Quand une règle correspond, elle a priorité sur la classification par défaut.

Cas d'usage :

  • Votre organisation utilise un fournisseur qu'EmailKind ne reconnaît pas
  • Vous souhaitez reclassifier certains domaines (ex : marquer un domaine comme "business" au lieu de "personal")
  • Vous avez des serveurs mail internes avec des enregistrements MX personnalisés

Types de règles

| Type | Description | Exemple | |---|---|---| | domain | Correspondance exacte du domaine | internal.company.com | | mx_pattern | Correspondance par pattern MX (wildcard) | *.mail.myhost.com |

Les règles domaine correspondent au domaine exact classifié. Elles ont la priorité la plus élevée.

Les règles MX pattern correspondent aux enregistrements MX du domaine classifié. Les wildcards (*) sont supportés :

  • *.example.com correspond à n'importe quel sous-domaine d'example.com
  • mx*.example.com correspond à mx1.example.com, mx2.example.com, etc.

Endpoints API

Lister les règles

GET /v1/rules

curl -H "Authorization: Bearer sk_live_VOTRE_CLE" \
  "https://emailkind.com/v1/rules"

Réponse :

{
  "success": true,
  "request_id": "req_abc123",
  "rules": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "match_type": "domain",
      "match_value": "internal.company.com",
      "provider_name": "Mail Interne",
      "provider_type": "business",
      "created_at": "2025-01-15T10:30:00Z"
    }
  ],
  "count": 1
}

Créer une règle

POST /v1/rules

curl -X POST -H "Authorization: Bearer sk_live_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{
    "match_type": "domain",
    "match_value": "internal.company.com",
    "provider_name": "Mail Interne",
    "provider_type": "business"
  }' \
  "https://emailkind.com/v1/rules"

Paramètres :

| Champ | Type | Requis | Description | |---|---|---|---| | match_type | string | Oui | domain ou mx_pattern | | match_value | string | Oui | Le domaine ou pattern MX à matcher | | provider_name | string | Oui | Nom d'affichage du fournisseur | | provider_type | string | Oui | business, personal, disposable, education, hosting ou self_hosted |

Réponse :

{
  "success": true,
  "request_id": "req_def456",
  "rule": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "match_type": "domain",
    "match_value": "internal.company.com",
    "provider_name": "Mail Interne",
    "provider_type": "business",
    "created_at": "2025-01-15T10:30:00Z"
  }
}

Supprimer une règle

DELETE /v1/rules/{id}

curl -X DELETE -H "Authorization: Bearer sk_live_VOTRE_CLE" \
  "https://emailkind.com/v1/rules/550e8400-e29b-41d4-a716-446655440000"

Limites

  • Maximum 50 règles par compte
  • Disponible à partir du plan Starter
  • Les règles sont appliquées en temps réel — pas de délai après la création
  • Si un domaine correspond à la fois à une règle domaine et une règle MX, la règle domaine a priorité

Impact sur la classification

Quand une règle personnalisée correspond, la réponse API inclut :

  • provider.id : custom_ suivi du nom du fournisseur (minuscules, underscores)
  • provider.name : Votre nom de fournisseur personnalisé
  • provider.type : Le type de fournisseur spécifié
  • confidence : 1.0 (puisque la correspondance est définie par l'utilisateur)
  • Les flags de classification (is_business, is_free, etc.) sont définis selon le type de fournisseur