Documentation API

URL de base

Production:https://api.quickname.tech

Limites de requêtes

Maximum 3 requêtes par heure par adresse IP. Si vous avez besoin de plus, contactez-nous.
Description du projet : 5 à 1024 caractères

POST/v1/request/Créer une demande

Crée une nouvelle demande de recherche de domaines. Après création, la demande est mise en file d'attente pour traitement.

Corps de la requête

Champ	Type	Description
user_description*	string	Description du projet (5-1024 caractères). Plus c'est détaillé, meilleures sont les suggestions.
zones	string[]	Liste des zones de domaine préférées (ex., ["com", "io"]). Optionnel.
domain_max_price	integer	Prix maximum du domaine en USD. Optionnel.

Exemple de requête

curl -X POST https://api.quickname.tech/v1/request/ \
  -H "Content-Type: application/json" \
  -d '{
    "user_description": "Marketplace en ligne de montres vintage",
    "zones": ["com", "io", "tech"],
    "domain_max_price": 100
  }'

Réponse 201 Created

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "user_description": "Marketplace en ligne de montres vintage",
  "zones": ["com", "io", "tech"],
  "domain_max_price": 100,
  "status": "created",
  "results": [],
  "is_valid": true
}

GET/v1/request/{'{'}request_id{'}'}/Obtenir le statut de la demande

Retourne l'état actuel d'une demande de recherche de domaines, y compris le statut de traitement et les résultats.

Statuts

created

processing

finished

error

Exemple de requête

curl https://api.quickname.tech/v1/request/123e4567-e89b-12d3-a456-426614174000/

Réponse 200 OK

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "user_description": "Marketplace en ligne de montres vintage",
  "zones": ["com", "io", "tech"],
  "status": "finished",
  "results": [
    {
      "domain": "techmarket.io",
      "price": 45,
      "availability": "available",
      "reasoning": "Combine 'tech' avec 'market' pour une marketplace technologique"
    }
  ],
  "is_valid": true
}

Champs de réponse

Objet Domain

Champ	Type	Description
domain	string	Nom de domaine complet (ex., example.com)
price	integer \| null	Prix du domaine en USD. Peut être null.
availability	string	Statut : available, unavailable ou unknown
reasoning	string \| null	Explication de l'IA pour cette suggestion

Codes d'erreur

Code	Description
400	Erreur de validation — vérifiez le corps de la requête
404	Demande non trouvée ou expirée (24 heures)
422	Format UUID invalide
429	Limite de requêtes dépassée (3 requêtes/heure)
500	Erreur interne du serveur

Retour à l'accueil