API
1.0.0 OpenAPI 3.1.0 методов: 20

Regex API

HTTP API Regex для программной регистрации доменов.

Авторизация: Authorization: Bearer <key>. Формат — JSON. Валюта — USD.

Ключ выдаётся в Telegram-боте: раздел «API-интеграция» → «Создать кабинет». Там же баланс, выпуск и отзыв ключей.

Инструкция

Доступ

  1. Откройте бота @REGEX_domainbot → «API-интеграция» → «Создать кабинет», затем «Ключи» → «Выпустить ключ».
  2. Передавайте ключ в заголовке Authorization: Bearer <ключ> в каждом запросе. Без ключа и с неверным ключом — ответ 401.
  3. Проверьте доступ запросом GET /v1/account: в ответе баланс и лимиты.

Покупка домена

  1. GET /v1/domains/search?name=example.com — свободен ли домен и сколько стоит.
  2. POST /v1/domains/register — купить, до 50 доменов за запрос. Деньги резервируются и списываются только за успешные.
  3. GET /v1/domains/{domain} — статус, срок и серверы имён.

Песочница

В v1 песочницы нет: каждый заказ — настоящий. Для отладки начните с v2 и тестового ключа regex_test_….

Деньги и формат

Формат — JSON, валюта — USD, время — ISO 8601 UTC. Баланс API пополняется в боте; заказ, который не прошёл, денег не списывает.

Аккаунт

Информация об аккаунте

GET/v1/account Требуется ключ

Возвращает баланс (available/reserved), тариф, дефолтные NS и лимиты партнёра. Баланс — снимок на момент запроса; блокировки строки здесь нет (это метод чтения, не изменения).

Ответы

  • 200 Успешный ответ
  • 422 Ошибка в параметрах
GET /v1/account
curl 'https://api.regexdomain.com/v1/account' \
  -H 'Authorization: Bearer YOUR_API_KEY'
{
  "partner_id": 0,
  "name": "string",
  "status": "active",
  "tier": "basic",
  "ns_mode": "auto",
  "default_nameservers": [
    "ns1.example.net"
  ],
  "resale_percent": "0",
  "balance": {
    "available": "35.00",
    "reserved": "35.00",
    "currency": "USD"
  },
  "limits": {
    "rate_limit_per_second": 0,
    "bulk_register_max": 50,
    "bulk_nameservers_max": 50
  }
}

Зоны и цены

Список зон и цен

GET/v1/zones Требуется ключ

Все поддерживаемые TLD с ценами регистрации и продления «для партнёра» (себестоимость + наценка). Читается из внутреннего кэша цен, обновляемого фоном раз в час — не бьёт по внешнему API на каждый запрос.

Ответы

  • 200 Успешный ответ
  • 422 Ошибка в параметрах
GET /v1/zones
curl 'https://api.regexdomain.com/v1/zones' \
  -H 'Authorization: Bearer YOUR_API_KEY'
{
  "zones": [
    {
      "tld": "com",
      "registration_usd": "string",
      "renewal_usd": "string",
      "registration_resale_usd": "string",
      "renewal_resale_usd": "string",
      "currency": "USD"
    }
  ],
  "count": 10
}

Подбор домена

Регистрация

Регистрация доменов (пакет, идемпотентно)

POST/v1/domains/register Требуется ключ

Пакетная регистрация до 50 доменов за один запрос. Порядок обработки одного элемента: проверка идемпотентности → расчёт цены → резерв средств (available → reserved) → создание заказа → регистрация → финальное списание (или возврат резерва при сбое). Повтор запроса с тем же idempotency_key вернёт прежний результат без второй регистрации. Ошибка на одном домене не отменяет остальные — смотри results[i].error_code.

Тело запроса

Имя Тип Описание
domainsобязательно object[]

Ответы

  • 200 Успешный ответ
  • 422 Ошибка в параметрах
POST /v1/domains/register
curl -X POST 'https://api.regexdomain.com/v1/domains/register' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"domains": [{"domain": "example.com", "idempotency_key": "order-42", "duration_years": 1, "nameservers": ["ns1.example.net"], "ns_mode": "auto"}]}'
{
  "results": [
    {
      "domain": "example.com",
      "idempotency_key": "order-42",
      "status": "registered",
      "order_id": 0,
      "price_partner_usd": "35.00",
      "resale_profit_usd": "0",
      "charged_usd": "0",
      "nameservers": [
        "ns1.example.net"
      ],
      "ns_mode": "auto",
      "registered_at": "2026-11-21T12:00:00Z",
      "expires_at": "2026-11-21T12:00:00Z",
      "idempotent_replay": false,
      "error_code": "string",
      "error_message": "string"
    }
  ],
  "balance": {
    "available": "35.00",
    "reserved": "35.00",
    "currency": "USD"
  }
}

Продление домена

POST/v1/domains/{domain}/renew Требуется ключ

Продлевает домен на 1..10 лет. Тот же холд/чардж/рефанд, что и у регистрации — при сбое возврат резерва автоматический.

Параметры

Имя Где Тип Описание
domainобязательно path string

Полное имя домена

Тело запроса

Имя Тип Описание
duration_years integer

Срок продления в годах.

Ответы

  • 200 Успешный ответ
  • 422 Ошибка в параметрах
POST /v1/domains/{domain}/renew
curl -X POST 'https://api.regexdomain.com/v1/domains/{domain}/renew' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"duration_years": 1}'
{
  "domain": "example.com",
  "order_id": 0,
  "status": "renewed",
  "duration_years": 0,
  "price_partner_usd": "35.00",
  "resale_profit_usd": "0",
  "charged_usd": "0",
  "expires_at": "2026-11-21T12:00:00Z",
  "error_code": "string",
  "error_message": "string",
  "balance": {
    "available": "35.00",
    "reserved": "35.00",
    "currency": "USD"
  }
}

Мои домены

Информация о домене

GET/v1/domains/{domain} Требуется ключ

Возвращает актуальный статус, срок действия и NS-серверы одного домена партнёра. Домен должен быть зарегистрирован через этот API (иначе 404 domain_not_found).

Параметры

Имя Где Тип Описание
domainобязательно path string

Полное имя домена

Ответы

  • 200 Успешный ответ
  • 422 Ошибка в параметрах
GET /v1/domains/{domain}
curl 'https://api.regexdomain.com/v1/domains/{domain}' \
  -H 'Authorization: Bearer YOUR_API_KEY'
{
  "domain": "example.com",
  "status": "string",
  "nameservers": [
    "ns1.example.net"
  ],
  "registered_at": "2026-11-21T12:00:00Z",
  "expires_at": "2026-11-21T12:00:00Z",
  "auto_renew": false,
  "whois_privacy": false,
  "ns_mode": "auto",
  "registrar_status": "string"
}

Список доменов партнёра

GET/v1/domains Требуется ключ

Возвращает домены партнёра со статусом registered с пагинацией по cursor. Первая страница — без параметра cursor; в ответе поле next_cursor подставляется в следующий запрос.

Параметры

Имя Где Тип Описание
cursor query integer

Cursor следующей страницы (order_id).

limit query integer

Размер страницы.

Ответы

  • 200 Успешный ответ
  • 422 Ошибка в параметрах
GET /v1/domains
curl 'https://api.regexdomain.com/v1/domains' \
  -H 'Authorization: Bearer YOUR_API_KEY'
{
  "items": [
    {
      "order_id": 0,
      "domain": "example.com",
      "registered_at": "2026-11-21T12:00:00Z",
      "expires_at": "2026-11-21T12:00:00Z",
      "ns_mode": "auto",
      "nameservers": [
        "ns1.example.net"
      ]
    }
  ],
  "next_cursor": 0
}

DNS-записи

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

GET/v1/domains/{domain}/dns Требуется ключ

Параметры

Имя Где Тип Описание
domainобязательно path string

Полное имя домена

Ответы

  • 200 Успешный ответ
  • 422 Ошибка в параметрах
GET /v1/domains/{domain}/dns
curl 'https://api.regexdomain.com/v1/domains/{domain}/dns' \
  -H 'Authorization: Bearer YOUR_API_KEY'
{
  "domain": "example.com",
  "records": [
    {
      "type": "a",
      "value": "203.0.113.10",
      "host": "",
      "mx_priority": 0,
      "redirect_code": 301
    }
  ]
}

Добавить одну DNS-запись

POST/v1/domains/{domain}/dns Требуется ключ

Добавляет одну запись к существующим. Для type=forward автоматически проверяет дубли, чтобы не плодить одинаковые редиректы.

Параметры

Имя Где Тип Описание
domainобязательно path string

Полное имя домена

Тело запроса

Имя Тип Описание
typeобязательно "a" | "aaaa" | "cname" | "mx" | "txt" | "ns"
valueобязательно string
host string
mx_priority integer
redirect_code integer

Только для type=forward: 301 (permanent) или 302 (temporary).

Ответы

  • 200 Успешный ответ
  • 422 Ошибка в параметрах
POST /v1/domains/{domain}/dns
curl -X POST 'https://api.regexdomain.com/v1/domains/{domain}/dns' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"type": "a", "value": "203.0.113.10", "host": "", "mx_priority": 0, "redirect_code": 301}'
{
  "domain": "example.com",
  "record": {
    "type": "a",
    "value": "203.0.113.10",
    "host": "",
    "mx_priority": 0,
    "redirect_code": 301
  }
}

Полная замена DNS-записей

PUT/v1/domains/{domain}/dns Требуется ключ

Ставит DNS-записи домена ровно в присланный набор — предыдущие записи стираются. Используй, когда партнёр держит финальное состояние зоны у себя.

Параметры

Имя Где Тип Описание
domainобязательно path string

Полное имя домена

Тело запроса

Имя Тип Описание
recordsобязательно object[]

Ответы

  • 200 Успешный ответ
  • 422 Ошибка в параметрах
PUT /v1/domains/{domain}/dns
curl -X PUT 'https://api.regexdomain.com/v1/domains/{domain}/dns' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"records": [{"type": "a", "value": "203.0.113.10", "host": "", "mx_priority": 0, "redirect_code": 301}]}'
{
  "domain": "example.com",
  "records": [
    {
      "type": "a",
      "value": "203.0.113.10",
      "host": "",
      "mx_priority": 0,
      "redirect_code": 301
    }
  ]
}

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

DELETE/v1/domains/{domain}/dns Требуется ключ

Удаляет запись, точно совпадающую по type, host, value. Возвращает количество удалённых (обычно 0 или 1).

Параметры

Имя Где Тип Описание
domainобязательно path string

Полное имя домена

Тело запроса

Имя Тип Описание
typeобязательно "a" | "aaaa" | "cname" | "mx" | "txt" | "ns"
valueобязательно string
host string
mx_priority integer
redirect_code integer

Только для type=forward: 301 (permanent) или 302 (temporary).

Ответы

  • 200 Успешный ответ
  • 422 Ошибка в параметрах
DELETE /v1/domains/{domain}/dns
curl -X DELETE 'https://api.regexdomain.com/v1/domains/{domain}/dns' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"type": "a", "value": "203.0.113.10", "host": "", "mx_priority": 0, "redirect_code": 301}'
{
  "domain": "example.com",
  "removed": 0
}

Nameservers

Смена NS (пакет)

PATCH/v1/domains/nameservers Требуется ключ

Пакетная смена NS-серверов до 50 доменов за один запрос. Домен должен принадлежать партнёру (быть зарегистрирован ранее через этот же API). Ошибка на одном домене не отменяет остальные.

NS под самим доменом (ns1.<домен>) должны быть заранее заведены как дочерние серверы имён (POST /domains/{domain}/nameserver-hosts). Если какого-то нет — элемент сразу получает status=failed и error_code=ns_missing_glue, в error_message перечислены недостающие хосты.

Тело запроса

Имя Тип Описание
domainsобязательно object[]

Ответы

  • 200 Успешный ответ
  • 422 Ошибка в параметрах
PATCH /v1/domains/nameservers
curl -X PATCH 'https://api.regexdomain.com/v1/domains/nameservers' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"domains": [{"domain": "example.com", "nameservers": ["ns1.example.net"]}]}'
{
  "results": [
    {
      "domain": "example.com",
      "status": "updated",
      "nameservers": [
        "ns1.example.net"
      ],
      "error_code": "string",
      "error_message": "string"
    }
  ]
}

Серверы имён

Список дочерних серверов имён

GET/v1/domains/{domain}/nameserver-hosts Требуется ключ

Хосты вида ns1.<домен>, заведённые в реестре для этого домена, с их адресами (glue-записи). Читается у реестра при каждом запросе (кэш до минуты, сбрасывается вашими же правками).

Параметры

Имя Где Тип Описание
domainобязательно path string

Полное имя домена

Ответы

  • 200 Успешный ответ
  • 422 Ошибка в параметрах
GET /v1/domains/{domain}/nameserver-hosts
curl 'https://api.regexdomain.com/v1/domains/{domain}/nameserver-hosts' \
  -H 'Authorization: Bearer YOUR_API_KEY'
{
  "domain": "example.com",
  "hosts": [
    {
      "host": "string",
      "ips": [
        "203.0.113.10"
      ]
    }
  ]
}

Завести дочерний сервер имён

POST/v1/domains/{domain}/nameserver-hosts Требуется ключ

Заводит в реестре хост под доменом (ns1.<домен>) с 1–4 адресами — без этого сменить домену NS на ns1.<домен> нельзя. Не больше 6 хостов на домен. Если домен стоит на наших NS, A/AAAA хоста сами появятся в его зоне (zone_records=updated). Делегирование домена не меняется: NS переключаются отдельно, PATCH /domains/nameservers.

Параметры

Имя Где Тип Описание
domainобязательно path string

Полное имя домена

Тело запроса

Имя Тип Описание
hostобязательно string

Метка (ns1) или полное имя (ns1.example.com). Хост — строго под этим доменом.

ipsобязательно string[]

1–4 публичных адреса. Частные сети и loopback не принимаются.

Ответы

  • 201 Успешный ответ
  • 422 Ошибка в параметрах
POST /v1/domains/{domain}/nameserver-hosts
curl -X POST 'https://api.regexdomain.com/v1/domains/{domain}/nameserver-hosts' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"host": "ns1", "ips": ["203.0.113.10"]}'
{
  "domain": "example.com",
  "host": {
    "host": "string",
    "ips": [
      "203.0.113.10"
    ]
  },
  "zone_records": "updated"
}

Сменить адреса дочернего сервера имён

PUT/v1/domains/{domain}/nameserver-hosts/{host} Требуется ключ

Заменяет адреса хоста целиком. Записи в нашей зоне — следом.

Параметры

Имя Где Тип Описание
domainобязательно path string

Полное имя домена

hostобязательно path string

Метка (ns1) или полное имя (ns1.example.com)

Тело запроса

Имя Тип Описание
ipsобязательно string[]

Новый набор адресов целиком: прежние заменяются.

Ответы

  • 200 Успешный ответ
  • 422 Ошибка в параметрах
PUT /v1/domains/{domain}/nameserver-hosts/{host}
curl -X PUT 'https://api.regexdomain.com/v1/domains/{domain}/nameserver-hosts/{host}' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"ips": ["203.0.113.10", "2001:db8::10"]}'
{
  "domain": "example.com",
  "host": {
    "host": "string",
    "ips": [
      "203.0.113.10"
    ]
  },
  "zone_records": "updated"
}

Удалить дочерний сервер имён

DELETE/v1/domains/{domain}/nameserver-hosts/{host} Требуется ключ

Удаляет хост из реестра и его A/AAAA из нашей зоны. Пока на хост делегирован хоть один домен, реестр откажет — 409 nameserver_host_in_use.

Параметры

Имя Где Тип Описание
domainобязательно path string

Полное имя домена

hostобязательно path string

Метка (ns1) или полное имя (ns1.example.com)

Ответы

  • 200 Успешный ответ
  • 422 Ошибка в параметрах
DELETE /v1/domains/{domain}/nameserver-hosts/{host}
curl -X DELETE 'https://api.regexdomain.com/v1/domains/{domain}/nameserver-hosts/{host}' \
  -H 'Authorization: Bearer YOUR_API_KEY'
{
  "domain": "example.com",
  "host": {
    "host": "string",
    "ips": [
      "203.0.113.10"
    ]
  },
  "zone_records": "updated"
}

Вебхуки

Список вебхуков

GET/v1/webhooks Требуется ключ

Ответы

  • 200 Успешный ответ
  • 422 Ошибка в параметрах
GET /v1/webhooks
curl 'https://api.regexdomain.com/v1/webhooks' \
  -H 'Authorization: Bearer YOUR_API_KEY'
{
  "items": [
    {
      "id": 0,
      "url": "https://example.com/hook",
      "events": [
        "string"
      ],
      "label": "string",
      "active": true,
      "created_at": "2026-11-21T12:00:00Z",
      "secret": "string"
    }
  ]
}

Создать вебхук

POST/v1/webhooks Требуется ключ

Создаёт endpoint и генерирует секрет подписи. Секрет возвращается ровно один раз — сохрани его. Восстановить потом нельзя (только пересоздать вебхук).

Тело запроса

Имя Тип Описание
urlобязательно string

HTTPS-URL, куда POST'ить события.

events "domain.registered" | "domain.failed" | "domain.expiring" | "domain.abuse_flagged" | "balance.low"[]

Подписки. Пустой список = все события.

label string

Ответы

  • 200 Успешный ответ
  • 422 Ошибка в параметрах
POST /v1/webhooks
curl -X POST 'https://api.regexdomain.com/v1/webhooks' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"url": "https://example.com/hook", "events": ["domain.registered"], "label": ""}'
{
  "id": 0,
  "url": "https://example.com/hook",
  "events": [
    "string"
  ],
  "label": "string",
  "active": true,
  "created_at": "2026-11-21T12:00:00Z",
  "secret": "string"
}

Удалить вебхук

DELETE/v1/webhooks/{webhook_id} Требуется ключ

Параметры

Имя Где Тип Описание
webhook_idобязательно path integer

Ответы

  • 204 Успешный ответ
  • 422 Ошибка в параметрах
DELETE /v1/webhooks/{webhook_id}
curl -X DELETE 'https://api.regexdomain.com/v1/webhooks/{webhook_id}' \
  -H 'Authorization: Bearer YOUR_API_KEY'
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Служебные

Проверка живости

GET/v1/health Без ключа

Простой health-check. Всегда возвращает 200, пока процесс жив. Используется nginx/Docker для liveness-проб.

Ответы

  • 200 Успешный ответ
GET /v1/health
curl 'https://api.regexdomain.com/v1/health'
{
  "status": "ok",
  "api_version": "string",
  "time": "2026-11-21T12:00:00Z"
}