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	最高域名价格（美元）。可选。

请求示例

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	域名价格（美元）。可能为 null。
availability	string	状态：available、unavailable 或 unknown
reasoning	string \| null	AI 对此建议的解释

错误代码

代码	描述
400	验证错误 — 检查请求体
404	请求未找到或已过期（24 小时）
422	UUID 格式无效
429	超出请求限制（每小时 3 个请求）
500	内部服务器错误

返回首页