Domains и Mail API

Во всех запросах передавайте Authorization: Bearer YOUR_API_KEY. DNS-записи вы добавляете у своего DNS-провайдера, а проверяет их Kratk: опрашивайте GET /api/domains/ID/status, пока нужные поля не станут true.

Для агентов и скриптов: полный справочник в Markdown — /docs/api/reference.md.

1. Добавить домен

curl -sS https://kratk.ru/api/domains \
  -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"go.example.com"}'

Ответ содержит id домена. Список — GET /api/domains, один домен — GET /api/domains/ID, удаление — DELETE /api/domains/ID.

2. Получить DNS-записи

curl -sS https://kratk.ru/api/domains/ID/dns \
  -H "Authorization: Bearer YOUR_API_KEY"

• Владение: TXT-запись с именем verifyHost и значением verifyToken
• Подключение: A-запись с именем recordHost на serverIp (CNAME на cnameTarget тоже принимается, но на одном имени с ним нельзя держать MX и SPF)
• Приём почты: MX-запись из inboundEmail (mxHost, priority, recordHost)

3. Проверить DNS

curl -sS https://kratk.ru/api/domains/ID/status \
  -H "Authorization: Bearer YOUR_API_KEY"

{ "ownership": true, "routing": true, "mx": false, "spf": false, "dkim": false, "dmarc": false }

ownership — найден TXT владения, routing — домен указывает на Kratk, mx — MX приёма почты, spf, dkim и dmarc — записи отправки (нужны все три). Найденное подтверждение сохраняется в домене автоматически.

4. Выпустить SSL

Доступно после подтверждения владения и направления домена.

curl -sS https://kratk.ru/api/domains/ID/ssl \
  -X POST \
  -H "Authorization: Bearer YOUR_API_KEY"

5. Приём писем

# включить (DELETE — отключить)
curl -sS https://kratk.ru/api/domains/ID/mail \
  -X POST -H "Authorization: Bearer YOUR_API_KEY"

Добавьте MX из шага 2 и дождитесь "mx": true в /status. Принятые письма читаются через Inbox API.

6. Отправка писем

# включить: создаст DKIM-ключ и вернёт записи SPF, DKIM и DMARC
curl -sS https://kratk.ru/api/domains/ID/mail/sending \
  -X POST -H "Authorization: Bearer YOUR_API_KEY"

{
  "verified": false,
  "records": {
    "spf":  { "type": "TXT", "host": "@", "value": "v=spf1 ip4:203.0.113.10 ~all" },
    "dkim": { "type": "TXT", "host": "kratk._domainkey", "value": "v=DKIM1; k=rsa; p=..." },
    "dmarc": { "type": "TXT", "host": "_dmarc", "value": "v=DMARC1; p=none;" }
  }
}

Повторно получить записи — GET /api/domains/ID/mail/sending, отключить и удалить ключ — DELETE. Если у домена уже есть SPF-запись, добавьте в неё ip4:… из ответа, а не создавайте вторую. Когда в /status spf, dkim и dmarc равны true, можно отправлять. Проверку можно запустить и явно: POST /api/domains/ID/mail/sending/verify.

Отправить письмо и журнал

POST /api/inbox/send и GET /api/inbox/sent описаны в Inbox API.

Коды ошибок

• 400 — шаг выполнен не по порядку (например, домен не подтверждён) или неверные данные
• 401 — ключ отсутствует, неверен или недоступен на тарифе
• 403 — функция недоступна на вашем тарифе
• 404 — домен не найден или принадлежит другому аккаунту
• 500 — внутренняя ошибка сервиса