Помощь и документация

Введение

HORiZONT cloud — платформа для управления поддоменами, DNS-записями и почтой. Через панель можно создавать поддомены на доменах ht-c.ru и ht-c.online, делегировать свои домены, управлять всеми типами DNS-записей и заводить почтовые ящики.

Для интеграций с внешними проектами используйте API v1. Документация и примеры — в разделе «Для разработчиков» в левом меню.

Домены и поддомены

Как создать поддомен?

Откройте панель управления и перейдите в раздел Домены.
Нажмите Создать поддомен.
Введите имя (латиница, цифры, дефис, подчёркивание).
Выберите родительский домен.
Нажмите Создать.

Как добавить свой домен от другого регистратора?

В разделе Домены нажмите Добавить свой домен.
Введите полное имя, например example.com.
У регистратора укажите NS-серверы:

ns1.ht-c.ru
ns2.ht-c.ru

Изменения вступят в силу через 1–24 часа.

Сколько поддоменов можно создать?

По умолчанию — 10 поддоменов на аккаунт. Лимит увеличивается по запросу у администратора.

Что делать, если поддомен занят?

Имена глобально уникальны. Если имя занято — выберите другое. Удалённый поддомен освобождает имя через несколько минут.

DNS-записи

Какие типы DNS-записей поддерживаются?

A — привязка домена к IPv4-адресу
AAAA — привязка к IPv6
CNAME — псевдоним для другого домена
MX — почтовый сервер
TXT — произвольный текст (SPF, DKIM, DMARC)
SRV — сервисы (Minecraft, VoIP)
NS — делегирование поддомена

Как добавить A-запись?

В разделе Домены нажмите Управление у поддомена.
Выберите тип A.
Имя: @ или www.
Значение — IPv4-адрес.
Нажмите Добавить.

Проверка:

dig @8.8.8.8 myapp.ht-c.ru A

Как настроить MX-запись?

Тип: MX
Имя: @
Приоритет: 10
Целевой сервер: mail.ht-c.ru

Как быстро распространяются изменения DNS?

На нашем DNS — мгновенно. Внешние резолверы обновляются по TTL. При TTL 300 секунд — до 5 минут.

Как настроить SRV для Minecraft?

Тип: SRV
Имя: _minecraft._tcp.play
Приоритет: 0
Вес: 5
Порт: 25565
Цель: mc.example.com

Почта

Как создать почтовый ящик?

Перейдите в раздел Почта.
Нажмите Создать.
Выберите поддомен.
Введите имя ящика и пароль.
Нажмите Создать.

Адрес: info@myapp.ht-c.ru.

Сколько ящиков можно создать?

По умолчанию — 3 на аккаунт. Лимит увеличивается по запросу.

Как читать почту в браузере?

Откройте mailbox.ht-c.ru и войдите. Доступны папки Входящие, Отправленные, Черновики, Удалённые, Спам, Архив. Можно добавить несколько аккаунтов и переключаться между ними.

Как настроить почтовый клиент?

Входящая (IMAP):

Сервер: mail.ht-c.ru
Порт: 993
Шифрование: SSL/TLS
Логин: полный email

Исходящая (SMTP):

Сервер: mail.ht-c.ru
Порт: 587
Шифрование: STARTTLS
Логин: полный email

Как настроить SPF, DKIM и DMARC?

SPF:

Имя: @
Значение: v=spf1 mx ~all

DMARC:

Имя: _dmarc
Значение: v=DMARC1; p=quarantine; rua=mailto:admin@вашдомен.ru

Аккаунт и безопасность

Как сменить логин, email или пароль?

В панели откройте Настройки — там три формы: логин, email, пароль. Изменения применяются мгновенно.

Забыли пароль?

На странице входа нажмите Забыли пароль?
Введите email.
Введите код из письма.
Придумайте новый пароль.

Как работает реферальная программа?

Вы получаете +5 ₽ за каждого приглашённого
Плюс 10% от его платежей
Приглашённый получает +10 ₽

Как работает мультиаккаунт?

В сайдбаре панели внизу — блок «Аккаунты». Клик по аккаунту переключает без пароля. Крестик — выход из конкретного. «Выйти из всех» — очистка списка.

API: Аутентификация

Базовый URL: https://ht-c.ru/cp-api/v1. Все запросы требуют токен, который передаётся одним из способов:

Authorization: Bearer <token>
X-API-Key: <token>
или параметр ?api_key=<token>

Токены создаются в панели управления: Настройки → API-токены. Каждый токен имеет права (scopes):

subdomains.read, subdomains.write
dns.read, dns.write
mailboxes.read, mailboxes.write
account.read
* — полный доступ

Лимит: 60 запросов в минуту на токен.

API: Поддомены

GET /cp-api/v1/subdomains

Список поддоменов с количеством DNS-записей

curl -H "Authorization: Bearer TOKEN" \
     https://ht-c.ru/cp-api/v1/subdomains

POST /cp-api/v1/subdomains

Создать поддомен

curl -X POST -H "Authorization: Bearer TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"subdomain":"myapp","domain":"ht-c.ru"}' \
     https://ht-c.ru/cp-api/v1/subdomains

DELETE /cp-api/v1/subdomains?id=123

Удалить поддомен и все его DNS-записи

API: DNS-записи

GET /cp-api/v1/dns?subdomain_id=123

Список DNS-записей поддомена

POST /cp-api/v1/dns

Создать запись. Типы: A, AAAA, CNAME, MX, TXT, SRV, NS

curl -X POST -H "Authorization: Bearer TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"subdomain_id":123,"type":"A","name":"@","content":"1.2.3.4","ttl":300}' \
     https://ht-c.ru/cp-api/v1/dns

DELETE /cp-api/v1/dns?id=456

Удалить DNS-запись

API: Почта

GET /cp-api/v1/mailboxes

Список ящиков

POST /cp-api/v1/mailboxes

Создать ящик

curl -X POST -H "Authorization: Bearer TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"subdomain_id":123,"localpart":"info","password":"StrongPass123"}' \
     https://ht-c.ru/cp-api/v1/mailboxes

DELETE /cp-api/v1/mailboxes?id=789

Удалить ящик

API: Аккаунт

GET /cp-api/v1/account

Профиль, баланс, лимиты, счётчики

curl -H "Authorization: Bearer TOKEN" \
     https://ht-c.ru/cp-api/v1/account

API: Примеры на языках

Python

import requests

API = "https://ht-c.ru/cp-api/v1"
TOKEN = "ваш_токен"
HEADERS = {"Authorization": f"Bearer {TOKEN}"}

# Список поддоменов
r = requests.get(f"{API}/subdomains", headers=HEADERS)
print(r.json())

# Создать A-запись
data = {"subdomain_id": 123, "type": "A", "name": "@", "content": "1.2.3.4", "ttl": 300}
r = requests.post(f"{API}/dns", headers=HEADERS, json=data)
print(r.json())

Node.js

const API = "https://ht-c.ru/cp-api/v1";
const TOKEN = "ваш_токен";

async function listSubdomains() {
    const res = await fetch(`${API}/subdomains`, {
        headers: { "Authorization": `Bearer ${TOKEN}` }
    });
    return await res.json();
}

async function createDns(subdomainId, type, content) {
    const res = await fetch(`${API}/dns`, {
        method: "POST",
        headers: {
            "Authorization": `Bearer ${TOKEN}`,
            "Content-Type": "application/json"
        },
        body: JSON.stringify({ subdomain_id: subdomainId, type, name: "@", content, ttl: 300 })
    });
    return await res.json();
}

PHP

$ch = curl_init('https://ht-c.ru/cp-api/v1/subdomains');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ВАШ_ТОКЕН'
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);

Частые проблемы

Почта не приходит

Проверьте MX: должен указывать на mail.ht-c.ru
Убедитесь, что ящик активен
Проверьте папку «Спам»
Настройте SPF и DMARC

Письма уходят в спам

Проверьте SPF: v=spf1 mx ~all
Проверьте DKIM — должен быть активен
Добавьте DMARC: v=DMARC1; p=none; rua=mailto:admin@домен

Поддомен не открывается

Проверьте запись: dig @8.8.8.8 поддомен.ht-c.ru
Подождите TTL — до 5 минут
Очистите кэш: ipconfig /flushdns

API возвращает 401

Токен передан в заголовке?
Токен не истёк?
Нет пробелов в начале/конце?

API возвращает 403

У токена нет нужного scope. Создайте новый с нужными правами в настройках.

API возвращает 429

Превышен лимит 60 запросов/минуту. Подождите минуту.

Справка