Documentation API

L'API DoomName vous permet de vérifier la disponibilité de noms de domaine et de gérer des alertes depuis votre propre application.

Base URL : https://www.doomname.com

API gratuite · 100 requêtes/jour · Aucune inscription requise — juste un e-mail pour recevoir votre clé.

Authentification

Toutes les requêtes sur /api/v1/ nécessitent une clé API passée dans le header HTTP :

Authorization: Bearer dk_votre_cle_api

Sans clé ou avec une clé invalide, vous recevrez une erreur 401.

Limites de taux

Chaque clé API est limitée à 100 requêtes par jour (remise à zéro à minuit UTC). Au-delà, vous recevrez une erreur 429.

Chaque réponse inclut les champs requests_today et daily_limit pour suivre votre consommation.

Codes d'erreur

CodeSignification
200Succès
400Paramètre manquant ou invalide
401Clé API manquante ou invalide
429Limite journalière atteinte
500Erreur serveur

Vérifier un domaine

GET /api/v1/check
Vérifie la disponibilité d'un nom de domaine via WHOIS en temps réel.

Paramètres

ParamètreTypeRequisDescription
domainstringOuiLe nom de domaine à vérifier (ex: exemple.com)

Requête

curl "https://www.doomname.com/api/v1/check?domain=exemple.com" \
  -H "Authorization: Bearer dk_votre_cle_api"

Réponse — domaine disponible

{
  "domain":         "exemple.com",
  "available":      true,
  "expiry":         null,
  "checked_at":     "2025-01-15T10:30:00.000Z",
  "requests_today": 1,
  "daily_limit":    100
}

Réponse — domaine pris

{
  "domain":         "google.com",
  "available":      false,
  "expiry":         "14/09/2028",
  "checked_at":     "2025-01-15T10:30:00.000Z",
  "requests_today": 2,
  "daily_limit":    100
}

S'abonner à une alerte

POST /api/v1/subscribe
Active une alerte e-mail pour être notifié dès qu'un domaine devient disponible.

Corps de la requête (JSON)

ParamètreTypeRequisDescription
domainstringOuiLe domaine à surveiller
emailstringOuiL'adresse e-mail qui recevra l'alerte

Requête

curl -X POST "https://www.doomname.com/api/v1/subscribe" \
  -H "Authorization: Bearer dk_votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{"domain": "mondomaine.fr", "email": "vous@exemple.com"}'

Réponse

{
  "success": true,
  "domain":  "mondomaine.fr",
  "email":   "vous@exemple.com",
  "message": "Alerte activée."
}

Se désabonner

DELETE /api/v1/unsubscribe
Désactive une alerte e-mail existante.

Corps de la requête (JSON)

ParamètreTypeRequisDescription
domainstringOuiLe domaine concerné
emailstringOuiL'adresse e-mail abonnée

Requête

curl -X DELETE "https://www.doomname.com/api/v1/unsubscribe" \
  -H "Authorization: Bearer dk_votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{"domain": "mondomaine.fr", "email": "vous@exemple.com"}'

Réponse

{
  "success": true,
  "message": "Alerte désactivée."
}

Obtenir une clé API

Entrez votre adresse e-mail pour recevoir votre clé API gratuitement. Vous pouvez créer jusqu'à 3 clés par adresse.

Pour vous souvenir à quoi sert cette clé.

Ne partagez pas votre clé API publiquement. Si elle est compromise, contactez-nous pour la révoquer.