API Документация

Базовый URL

Production:https://api.quickname.tech

Лимиты запросов

Максимум 3 запроса в час с одного IP-адреса. Если нужно больше, напишите нам.
Описание проекта: от 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	Внутренняя ошибка сервера

Вернуться на главную