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	Внутрішня помилка сервера

Повернутися на головну