API दस्तावेज़

बेस URL

Production:https://api.quickname.tech

अनुरोध सीमाएं

प्रति IP पता प्रति घंटे अधिकतम 3 अनुरोध। यदि अधिक चाहिए, तो हमसे संपर्क करें।
प्रोजेक्ट विवरण: 5 से 1024 अक्षर

POST/v1/request/अनुरोध बनाएं

एक नया डोमेन खोज अनुरोध बनाता है। निर्माण के बाद, अनुरोध प्रसंस्करण के लिए कतार में लगा दिया जाता है।

अनुरोध बॉडी

फ़ील्ड	प्रकार	विवरण
user_description*	string	प्रोजेक्ट विवरण (5-1024 अक्षर)। जितना विस्तृत, उतने बेहतर सुझाव।
zones	string[]	पसंदीदा डोमेन ज़ोन की सूची (उदा., ["com", "io"])। वैकल्पिक।
domain_max_price	integer	USD में अधिकतम डोमेन मूल्य। वैकल्पिक।

अनुरोध उदाहरण

curl -X POST https://api.quickname.tech/v1/request/ \
  -H "Content-Type: application/json" \
  -d '{
    "user_description": "विंटेज घड़ियों का ऑनलाइन मार्केटप्लेस",
    "zones": ["com", "io", "tech"],
    "domain_max_price": 100
  }'

प्रतिक्रिया 201 Created

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "user_description": "विंटेज घड़ियों का ऑनलाइन मार्केटप्लेस",
  "zones": ["com", "io", "tech"],
  "domain_max_price": 100,
  "status": "created",
  "results": [],
  "is_valid": true
}

GET/v1/request/{'{'}request_id{'}'}/अनुरोध स्थिति प्राप्त करें

डोमेन खोज अनुरोध की वर्तमान स्थिति लौटाता है, जिसमें प्रसंस्करण स्थिति और परिणाम शामिल हैं।

स्थितियां

created

processing

finished

error

अनुरोध उदाहरण

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

प्रतिक्रिया 200 OK

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "user_description": "विंटेज घड़ियों का ऑनलाइन मार्केटप्लेस",
  "zones": ["com", "io", "tech"],
  "status": "finished",
  "results": [
    {
      "domain": "techmarket.io",
      "price": 45,
      "availability": "available",
      "reasoning": "टेक्नोलॉजी मार्केटप्लेस के लिए 'tech' और 'market' को जोड़ता है"
    }
  ],
  "is_valid": true
}

प्रतिक्रिया फ़ील्ड

Domain ऑब्जेक्ट

फ़ील्ड	प्रकार	विवरण
domain	string	पूर्ण डोमेन नाम (उदा., example.com)
price	integer \| null	USD में डोमेन मूल्य। null हो सकता है।
availability	string	स्थिति: available, unavailable, या unknown
reasoning	string \| null	इस सुझाव के लिए AI व्याख्या

त्रुटि कोड

कोड	विवरण
400	सत्यापन त्रुटि — अनुरोध बॉडी जांचें
404	अनुरोध नहीं मिला या समाप्त हो गया (24 घंटे)
422	अमान्य UUID प्रारूप
429	अनुरोध सीमा पार हो गई (3 अनुरोध/घंटा)
500	आंतरिक सर्वर त्रुटि

होम पर वापस जाएं