volhit/domexpy repository overview

⁠API для проверки срока регистрации доменов

Так как мне нужно, добавлена обработка доменов .place, которой не было в оригинальном gem 'whois'.

⁠Описание

Это простейшее веб-приложение на Ruby (Roda), предоставляющее JSON API для проверки доменов. Сервис позволяет узнать:

• дату окончания регистрации домена,
• сколько дней осталось до окончания регистрации,
• активен ли домен (валиден),

Доступ к API защищён токеном (указывается в переменной окружения или используется значение по умолчанию). Все запросы и ответы — только в формате JSON.

⁠Переменные окружения

• PORT — порт, на котором будет запущено приложение (по умолчанию 4000
• RACK_ENV — окружение Rack (по умолчанию development)
• WEB_CONCURRENCY — количество воркеров Puma (по умолчанию 2)
• MAX_THREADS — количество потоков на воркер Puma (по умолчанию 1)
• API_TOKEN — токен для доступа к API (по умолчанию: very-simple-app-token)

⁠API

⁠Защита

Для доступа к API требуется токен. Токен указывается в переменной окружения API_TOKEN и передаётся в заголовке Authorization в формате:

Authorization: Bearer <ваш_токен>

⁠Запрос

• Метод: POST
• URL: /api
• Content-Type: application/json
• Тело запроса:

{
  "domain": "example.place"
}

⁠Ответ

• Успешный ответ:

{
  "domain": "example.place",
  "expires_on": "2025-01-01",
  "days_left": 123,
  "valid": true
}

• Ошибки:
  • 401 Unauthorized — неверный токен
  • 415 Unsupported Media Type — неверный Content-Type
  • 500 — ошибка WHOIS

⁠Copyright

Author: Viacheslav Perederenko⁠, 2025