# Regex API v2 > Партнёрский API регистрации доменов: поиск, котировки, заказы (регистрация и продление), домены, DNS, вебхуки. Только предоплата: деньги резервируются и списываются с баланса API, автосписаний нет. Base URL: https://api.regexdomain.com/v2. Ключ — заголовок Authorization: Bearer <ключ>. Ключ песочницы regex_test_… — $1000 игровых, без настоящих денег и доменов: начинайте с него. Правила: деньги — строкой ("12.50"); время — ISO-8601 UTC; платные запросы требуют заголовок Idempotency-Key (повтор с тем же ключом не спишет дважды); ошибка — {"error": {code, message, hint, request_id, docs_url}}. Покупка: POST /quotes (цена на 10 минут, ничего не списывает) → POST /orders с quote_id (спишется ровно сумма котировки). ## Описание - [OpenAPI 3.1](https://api.regexdomain.com/v2/openapi.json): все методы и схемы - [Postman](https://api.regexdomain.com/v2/postman.json): коллекция с примерами - [Документация](https://api.regexdomain.com/v2/docs): для людей, с «Попробовать» в песочнице ## Аккаунт - GET /account — Баланс и лимиты: Доступный и зарезервированный баланс, ваша наценка и лимит запросов. У ключа песочницы — игровой баланс и sandbox: true. - GET /account/transactions — Выписка: Все движения баланса, новые сверху: пополнения, резервы, списания, возвраты. У каждой строки — остаток после неё. У песочницы выписка пустая: игровые деньги видны в заказах. - POST /account/topups — Пополнить баланс [Idempotency-Key]: Счёт теми же кассами, что в боте: cryptobot, xrocket, usdt_trc20, usdt_bep20. Только предоплата — баланс API растёт после оплаты. Нужен Idempotency-Key: повтор вернёт тот же счёт. Песочница зачисляет игровые деньги сразу. - GET /account/topups/{id} — Статус пополнения: awaiting_payment → processing (оплачено) → credited. Если перевести на баланс API не удалось, деньги остаются на личном балансе бота: on_personal_balance и причина в reason. - GET /keys — Ключи: Действующие ключи аккаунта: префикс, права, метка. Сам ключ не показывается. Только для ключа с правами full. - POST /keys — Выпустить ключ: Права: read — только чтение, dns — чтение и правка DNS, full — всё. Ключ того же режима, что и ваш: тестовым ключом — тестовый. Сам ключ приходит один раз, в ответе. В v1 ключ с правами read или dns не работает. - DELETE /keys/{prefix} — Отозвать ключ: Ключ, которым сделан запрос, отозвать нельзя — key_self_revoke. ## Поиск и цены - GET /zones — Зоны и цены: Все зоны, которые можно купить через API: цена регистрации и продления, ваша наценка и итог к списанию. - POST /domains/search — Проверка имён: До 100 имён за один запрос. У свободных — цена регистрации и продления. Имя с ошибкой или зона, которую мы не продаём, — error у этого имени, остальные проверяются как обычно. - GET /domains/suggest — Подбор имён: Свободные варианты по слову — в популярных зонах и с ценами. Готовая кнопка «подобрать» для вашей витрины. Занятые не показываются. - POST /quotes — Котировка: Закрепляет цену на 10 минут. Заказ по quote_id спишет ровно показанную сумму. Если за это время реестр поднял цену, заказ отклоняется кодом quote_price_changed без списания. ## Заказы - POST /orders — Создать заказ [Idempotency-Key]: Принимает quote_id или список items — что-то одно. Действия: register и renew; перенос — заявкой, не заказом. Позиции проводятся по очереди, у каждой свой резерв: не получилось — резерв возвращается сам, выполненные позиции остаются. customer_ref и labels переходят на купленные домены. - GET /orders/{id} — Статус заказа: completed — все позиции выполнены, partial — часть, failed — ни одной (резерв вернулся). pending — заказ ещё в работе. Итог приходит и вебхуком: order.completed (в том числе partial) или order.failed. - GET /orders — Список заказов: Все заказы, новые сверху, — для сверки и разбора спорных случаев. ## Домены - GET /domains — Список доменов: Фильтры складываются. «Все домены клиента 42, истекающие до конца года» — один запрос. count — сколько доменов под фильтр. - GET /domains/{domain} — Карточка домена: Статус и что с доменом можно сделать прямо сейчас: actions. У истёкшего домена остаётся только renew. - PATCH /domains/{domain} — Метки клиента: Привяжите домен к своему клиенту: customer_ref и labels потом работают как фильтры списка. Меняется только то, что передано; "customer_ref": null стирает его. - POST /domains/{domain}/transfer-requests — Заявка на перенос: Перенос домена к другому регистратору — заявкой: она уходит нам, код переноса передаём вручную. Деньги не списываются. Одна открытая заявка на домен. Решение придёт вебхуком transfer.updated. - GET /domains/{domain}/transfer-requests — Заявки по домену: Все заявки на перенос этого домена, новые сверху. - GET /transfer-requests — Все заявки на перенос: open — ждёт нас, done — выполнено, refused — отказ (причина в reason), cancelled — вы отозвали. - GET /transfer-requests/{id} — Статус заявки: Одна заявка по id. - DELETE /transfer-requests/{id} — Отозвать заявку: Только открытую; закрытую — transfer_request_closed. ## DNS - GET /domains/{domain}/dns — Записи: Все записи домена. host пустой — корень домена. - PUT /domains/{domain}/dns — Заменить набор: Полная замена пачкой, до 100 записей: всё, чего нет в запросе, будет удалено. После записи — вебхук dns.changed. - POST /domains/{domain}/dns/templates — Применить шаблон: Шаблоны: vercel, github_pages (нужен params.user), google_workspace, redirect (нужен params.url, params.code — 301 или 302). Записи шаблона сводятся с текущими: A, AAAA, CNAME и редирект на том же имени заменяются, MX и TXT дописываются. В ответе — итоговый набор. ## Серверы имён - PUT /domains/{domain}/nameservers — Сменить NS: От 2 до 13 серверов имён. NS под самим доменом (ns1.<домен>) — только после того, как заведён дочерний сервер (ниже), иначе ns_missing_glue со списком недостающих. После смены — вебхук dns.changed. - PATCH /domains/nameservers — Сменить NS пачкой: До 50 доменов. Ошибка одного не отменяет остальные — error у элемента. - GET /domains/{domain}/nameserver-hosts — Дочерние серверы: Хосты вида ns1.<домен> и их адреса в реестре. - POST /domains/{domain}/nameserver-hosts — Завести дочерний сервер: Имя ns1 или ns1.<домен> и 1–4 адреса IPv4/IPv6 из интернета. Не больше 6 на домен. - PUT /domains/{domain}/nameserver-hosts/{host} — Сменить адреса: Новый набор адресов заменяет старый. - DELETE /domains/{domain}/nameserver-hosts/{host} — Удалить дочерний сервер: Пока на хост делегирован хоть один домен, реестр откажет — nameserver_host_in_use. ## Вебхуки - GET /webhooks — Подписки: Все адреса и события, на которые они подписаны. Адреса, заведённые в v1, получают только пять событий v1. - POST /webhooks — Подписаться: Пустой events — все события. Адрес — публичный, не локальный. Секрет для подписи показывается один раз, в ответе. Не больше 10 адресов. Адрес, заведённый тестовым ключом, получает только события песочницы; удалять адреса и менять им секрет можно только боевым ключом. - DELETE /webhooks/{id} — Отписаться: Доставки, стоящие в очереди, отменяются. - POST /webhooks/{id}/test — Проверочный вызов: Отправит событие webhook.test на этот адрес — проверить адрес и подпись. Подписка не нужна. - POST /webhooks/{id}/secret — Сменить секрет: Новый секрет подписи приходит один раз, в ответе. Старый перестаёт действовать сразу — обновите проверку подписи. - GET /webhooks/{id}/deliveries — Журнал доставок: Каждое событие: статус, сколько попыток, код ответа и ошибка. - POST /webhooks/{id}/deliveries/{event_id}/retry — Повторить доставку: Неудачная доставка снова встаёт в очередь с полным набором попыток. Повторить можно только failed. ## Платёжка USDT - POST /payments — Выставить счёт: Возвращает ссылку pay_url — отправьте на неё клиента. Сумма к переводу pay_amount = ваша цена + ваша надбавка из кабинета + уникальные центы. Без network при двух кошельках сеть выберет клиент на странице оплаты (до выбора network, wallet и pay_amount — null). Idempotency-Key не обязателен, но с ним повтор после обрыва вернёт тот же счёт. - GET /payments — Счета: Новые сверху. - GET /payments/{id} — Статус счёта: Бесплатно и без лимита на число счетов. paid — перевод подтверждён сетью, в ответе tx_hash и payer. - POST /payments/{id}/cancel — Отменить счёт: Только ожидающий. Перевод, который клиент успел отправить, не потеряется — он будет в кабинете среди не совпавших. - POST /payments/{id}/simulate — Песочница: оплатить: Только ключом regex_test_…: счёт песочницы становится paid, уходит вебхук payment.paid с sandbox: true. ## Служебные - GET /health — Состояние: Без ключа. 200 — сервис отвечает. - POST /sandbox/reset — Сбросить песочницу: Только для ключей regex_test_…: баланс снова $1000, тестовые домены, их метки, записи и заказы стираются. ## Ошибки - bad_request (400): Запрос не разобран. Подробности — в message. - unauthorized (401): Нет ключа или он отозван. Проверьте заголовок Authorization. - insufficient_scope (403): У ключа с правами read или dns нет прав на этот метод. - ip_not_allowed (403): Запрос с адреса, которого нет в списке ключа. - validation_failed (422): Поле не прошло проверку — какое, сказано в hint. - idempotency_key_required (400): Платный метод без заголовка Idempotency-Key. - idempotency_key_invalid (400): Idempotency-Key: 8–128 символов из латиницы, цифр и - _ : . - idempotency_conflict (409): Тот же Idempotency-Key пришёл с другим телом. - idempotency_in_progress (409): Первый запрос с этим ключом ещё выполняется. Повторите через Retry-After. - rate_limited (429): Слишком часто. Подождите Retry-After секунд. - insufficient_balance (402): Не хватает денег на балансе. Пополните в боте. - quote_not_found (404): Такой котировки нет — проверьте quote_id. - quote_expired (409): Котировке больше 10 минут — запросите новую. - quote_already_used (409): По этой котировке уже оформлен заказ. Одна котировка — один заказ. - quote_price_changed (409): Реестр поднял цену. Запросите новую котировку, списания не было. - domain_invalid (400): Имя домена записано с ошибкой. - domain_unavailable (409): Имя уже занято. - domain_not_found (404): Такого домена нет среди ваших. - order_not_found (404): Такого заказа нет среди ваших. - action_not_supported (422): Такого действия в заказе нет. Перенос — заявкой: POST /domains/{domain}/transfer-requests. - transfer_request_exists (409): По домену уже есть открытая заявка на перенос. - transfer_request_not_found (404): Такой заявки нет среди ваших. - transfer_request_closed (409): Заявка уже закрыта — отозвать можно только открытую. - sandbox_only (403): Метод песочницы — вызовите его ключом regex_test_… - zone_not_supported (422): Зону не продаём — список в GET /zones. - key_not_found (404): Такого действующего ключа нет. - key_limit_reached (409): Действующих ключей уже 5 — отзовите ненужный. - key_self_revoke (409): Ключ, которым сделан запрос, отозвать нельзя. - template_not_found (404): Такого DNS-шаблона нет. - webhook_not_found (404): Такого вебхука нет среди ваших. - webhook_url_rejected (422): Адрес вебхука локальный или внутренний — нужен публичный. - webhook_limit_reached (409): Вебхуков уже 10 — удалите ненужный. - delivery_not_found (404): Такой доставки нет у этого вебхука. - delivery_not_failed (409): Повторить можно только доставку в статусе failed. - ns_missing_glue (409): NS под самим доменом без дочернего сервера — сначала заведите его. - nameserver_host_invalid (422): Хост должен быть под самим доменом: ns1 или ns1.<домен>. - nameserver_host_exists (409): Такой дочерний сервер уже заведён — для смены адресов PUT. - nameserver_host_not_found (404): Такого дочернего сервера нет. - nameserver_host_in_use (409): На хост делегированы домены — сначала смените им NS. - too_many_nameserver_hosts (409): Не больше 6 дочерних серверов на домен. - ip_invalid (422): Адрес IP записан с ошибкой. - ip_not_routable (422): Адрес недоступен из интернета (частная сеть, loopback). - topup_invalid (422): Сумма от $1 до $10000, способ — cryptobot, xrocket, usdt_trc20 или usdt_bep20. - topup_below_min (422): Первое пополнение баланса API ниже минимальной суммы. - topup_not_found (404): Такого счёта нет среди ваших. - topup_owner_missing (409): У кабинета нет владельца в боте — пополните в боте. - payments_not_enabled (403): Платёжка не подключена — укажите кошелёк в кабинете. - payments_disabled (403): Платёжка для кабинета отключена — напишите в поддержку. - network_not_configured (422): Для этой сети в кабинете нет кошелька. - payment_invalid (422): Счёт не прошёл проверку — какое поле, сказано в message. - payment_amount_busy (409): На эту сумму слишком много ожидающих счетов — измените сумму или повторите позже. - payment_not_found (404): Такого счёта нет среди ваших. - payment_not_pending (409): Счёт уже оплачен, истёк или отменён. - not_found (404): Такого метода нет — проверьте адрес. - method_not_allowed (405): Метод есть, но с другим HTTP-глаголом. - service_unavailable (503): Временный сбой. Повторите с тем же Idempotency-Key. - internal_error (500): Наша ошибка. Пришлите request_id в поддержку. ## События вебхуков - order.completed: Заказ выполнен — все позиции или часть (partial) - order.failed: Заказ не прошёл, резерв вернулся на баланс - domain.registered: Домен зарегистрирован - domain.failed: Регистрация домена не прошла - domain.renewed: Домен продлён - domain.expiring: Домен истекает через 30, 7 или 1 день - domain.expired: Срок домена закончился - domain.abuse_flagged: На домен пришла жалоба - dns.changed: Записи домена изменились - balance.credited: Баланс пополнен - balance.low: Баланс ниже порога - transfer.updated: Владелец закрыл заявку на перенос: done или refused - payment.paid: Счёт платёжки оплачен: в теле счёт целиком — order_id, tx_hash, payer - payment.expired: Счёт платёжки истёк без оплаты - webhook.test: Проверочный вызов