К содержанию
regex API v2

Partner API · v2

Домены в вашем продукте — за один вечер

Поиск, регистрация, DNS и вебхуки одним API. Цена закрепляется до оплаты, повтор запроса не спишет деньги дважды, а песочница даёт $1000 игровых, чтобы всё проверить без риска.

  • 45методов
  • 15событий вебхуков
  • 10 минцена закреплена
  • $1000в песочнице

Быстрый старт

Четыре шага от ключа до купленного домена. Ключ — в боте: «API-интеграция» → «Ключи». Сохраните его в переменную REGEX_KEY.

Ключ остаётся в этой вкладке браузера. Боевой ключ здесь не работает — только песочница.

  1. 1

    Проверьте ключ

    Тестовый ключ regex_test_… работает в песочнице: $1000 игровых, настоящих денег и доменов за ним нет. Начинайте с него. Работает он только в v2 — API v1 тестовый ключ не принимает.

    curl https://api.regexdomain.com/v2/account \
      -H "Authorization: Bearer $REGEX_KEY"
  2. 2

    Проверьте имена

    До 100 имён за запрос. В ответе — свободно ли и почём для вас и для вашего клиента.

    curl https://api.regexdomain.com/v2/domains/search \
      -H "Authorization: Bearer $REGEX_KEY" \
      -H "Content-Type: application/json" \
      -d '{"names": ["mybrand.com", "mybrand.io", "mybrand.xyz"]}'
  3. 3

    Закрепите цену

    Котировка держит цену 10 минут: клиенту показываете ровно ту сумму, которая потом спишется.

    curl https://api.regexdomain.com/v2/quotes \
      -H "Authorization: Bearer $REGEX_KEY" \
      -H "Content-Type: application/json" \
      -d '{"items": [{"action": "register", "domain": "mybrand.io", "years": 1}]}'
  4. 4

    Оформите заказ

    Idempotency-Key — любая уникальная строка. Оборвалась сеть — повторите запрос с тем же ключом: второго списания не будет.

    curl https://api.regexdomain.com/v2/orders \
      -H "Authorization: Bearer $REGEX_KEY" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: 6f1c2a0e-order-42" \
      -d '{"quote_id": "qt_8KfZ2", "customer_ref": "client-42"}'

Основы

Восемь правил, общих для всех методов.

Ключи и права

Ключ выдаётся в боте: «API-интеграция» → «Ключи». У ключа есть права: full — всё, dns — чтение и DNS, read — только чтение. Ключ с урезанными правами выпускает POST /keys; его и отдавайте фронтенду — он не умеет тратить деньги.

Authorization: Bearer regex_live_…

Песочница

Ключ regex_test_… живёт в песочнице: $1000 игровых, заказы и вебхуки настоящие по форме, но к реестру ничего не уходит. Сброс — POST /sandbox/reset.

fail-balance.test · fail-taken.test · slow.test

Защита от повтора

Каждый платный запрос принимает Idempotency-Key. Повтор с тем же ключом вернёт прежний ответ, а не создаст второй заказ. Тот же ключ с другим телом — ошибка idempotency_conflict.

Idempotency-Key: 6f1c2a0e-order-42

Лимиты

Каждый ответ сообщает, сколько запросов осталось в окне. При 429 Retry-After говорит, сколько секунд подождать.

RateLimit-Remaining: 9 · Retry-After: 1

Деньги

Суммы приходят строкой, в долларах: "12.50". У каждой позиции — price (наша цена), markup (ваша наценка из кабинета) и total (списано с баланса).

{"price": "11.00", "markup": "1.50", "total": "12.50"}

Ошибки

Ответ с ошибкой всегда одного вида: код, текст, подсказка, request_id для поддержки и ссылка на описание кода.

{"error": {"code": "quote_expired", …}}

Пагинация

Списки отдаются страницами по курсору. next_cursor из ответа передайте в следующий запрос; null — это последняя страница.

GET /domains?limit=100&cursor=c_Q2x9

Время и формат

JSON в UTF-8, время — ISO-8601 в UTC. Имена доменов принимаем в любом регистре и в юникоде, отдаём в нижнем регистре.

"expires_at": "2027-11-16T09:20:00Z"

Аккаунт

Баланс, лимиты, выписка по деньгам и ключи с правами.

GET /account Баланс и лимиты

Доступный и зарезервированный баланс, ваша наценка и лимит запросов. У ключа песочницы — игровой баланс и sandbox: true.

Попробовать в песочнице

Ответ 200

{
  "partner_id": 31,
  "name": "Acme",
  "status": "active",
  "markup_percent": "10.00",
  "balance": { "available": "184.20", "reserved": "12.50", "currency": "USD" },
  "rate_limit": { "per_second": 10 },
  "sandbox": false
}
GET /account/transactions Выписка

Все движения баланса, новые сверху: пополнения, резервы, списания, возвраты. У каждой строки — остаток после неё. У песочницы выписка пустая: игровые деньги видны в заказах.

ПараметрТипОписание
from date С какой даты, включительно
to date По какую дату, включительно
type string deposit · hold · charge · refund · cashback · adjustment
limit int До 200, по умолчанию 50
cursor string Курсор следующей страницы

Попробовать в песочнице

Ответ 200

{
  "items": [
    { "id": "tx_912", "type": "hold", "amount": "-12.50",
      "available_after": "171.70", "reserved_after": "12.50",
      "note": "", "created_at": "2026-11-16T09:20:11Z" }
  ],
  "next_cursor": null
}
POST /account/topups Пополнить баланс Idempotency-Key

Счёт теми же кассами, что в боте: cryptobot, xrocket, usdt_trc20, usdt_bep20. Только предоплата — баланс API растёт после оплаты. Нужен Idempotency-Key: повтор вернёт тот же счёт. Песочница зачисляет игровые деньги сразу.

Запрос

{ "amount": "50.00", "method": "cryptobot" }

Попробовать в песочнице

Ответ 200

{ "id": "tp_812", "amount": "50.00", "method": "cryptobot",
  "status": "awaiting_payment", "pay_url": "https://t.me/…" }
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 не работает.

Запрос

{ "scope": "read", "label": "витрина", "ip_whitelist": [] }

Попробовать в песочнице

Ответ 200

{ "prefix": "regex_live_8kQ", "scope": "read", "label": "витрина",
  "test": false, "key": "regex_live_8kQ…" }
DELETE /keys/{prefix} Отозвать ключ

Ключ, которым сделан запрос, отозвать нельзя — key_self_revoke.

Попробовать в песочнице

Заказы

Регистрация и продление — один вид заказа со статусом.

POST /orders Создать заказ Idempotency-Key

Принимает quote_id или список items — что-то одно. Действия: register и renew; перенос — заявкой, не заказом. Позиции проводятся по очереди, у каждой свой резерв: не получилось — резерв возвращается сам, выполненные позиции остаются. customer_ref и labels переходят на купленные домены.

Запрос

{
  "quote_id": "qt_8KfZ2",
  "customer_ref": "client-42",
  "labels": ["landing"],
  "nameservers": ["ns1.example.net", "ns2.example.net"]
}

Попробовать в песочнице

Ответ 200

{
  "id": "ord_7Hx2",
  "status": "completed",
  "quote_id": "qt_8KfZ2",
  "customer_ref": "client-42",
  "items": [
    { "action": "register", "domain": "mybrand.io", "years": 1,
      "status": "completed", "price": "52.00", "markup": "3.00", "total": "55.00",
      "expires_at": "2027-11-16T09:21:30Z", "error": null }
  ],
  "total": "55.00",
  "created_at": "2026-11-16T09:21:04Z"
}
GET /orders/{id} Статус заказа

completed — все позиции выполнены, partial — часть, failed — ни одной (резерв вернулся). pending — заказ ещё в работе. Итог приходит и вебхуком: order.completed (в том числе partial) или order.failed.

Попробовать в песочнице

Ответ 200

{
  "id": "ord_7Hx2",
  "status": "completed",
  "items": [
    { "action": "register", "domain": "mybrand.io", "status": "completed",
      "expires_at": "2027-11-16T09:21:30Z", "total": "55.00" }
  ]
}
GET /orders Список заказов

Все заказы, новые сверху, — для сверки и разбора спорных случаев.

ПараметрТипОписание
status string pending · completed · partial · failed · refunded
limit int До 200, по умолчанию 50
cursor string Курсор следующей страницы

Попробовать в песочнице

Домены

Ваши домены: список с фильтрами, карточка и метки клиентов.

GET /domains Список доменов

Фильтры складываются. «Все домены клиента 42, истекающие до конца года» — один запрос. count — сколько доменов под фильтр.

ПараметрТипОписание
status string active · expiring (меньше 30 дней) · expired
zone string com, io, eu.com, …
expires_before date Истекают до даты
customer_ref string Ваш ID клиента
label string Метка
sort string expires_at (по умолчанию) · -expires_at · domain · registered_at
limit int До 200, по умолчанию 50
cursor string Курсор следующей страницы

Попробовать в песочнице

Ответ 200

{
  "items": [
    { "domain": "mybrand.io", "zone": "io", "status": "active",
      "actions": ["renew", "dns", "nameservers"],
      "expires_at": "2027-11-16T09:21:30Z", "customer_ref": "client-42",
      "labels": ["landing"] }
  ],
  "count": 1,
  "next_cursor": null
}
GET /domains/{domain} Карточка домена

Статус и что с доменом можно сделать прямо сейчас: actions. У истёкшего домена остаётся только renew.

Попробовать в песочнице

Ответ 200

{
  "domain": "mybrand.io",
  "zone": "io",
  "status": "active",
  "actions": ["renew", "dns", "nameservers"],
  "registered_at": "2026-11-16T09:21:30Z",
  "expires_at": "2027-11-16T09:21:30Z",
  "nameservers": ["ns1.example.net", "ns2.example.net"],
  "customer_ref": "client-42",
  "labels": ["landing"],
  "sandbox": false
}
PATCH /domains/{domain} Метки клиента

Привяжите домен к своему клиенту: customer_ref и labels потом работают как фильтры списка. Меняется только то, что передано; "customer_ref": null стирает его.

Запрос

{ "customer_ref": "client-42", "labels": ["landing", "promo"] }

Попробовать в песочнице

POST /domains/{domain}/transfer-requests Заявка на перенос

Перенос домена к другому регистратору — заявкой: она уходит нам, код переноса передаём вручную. Деньги не списываются. Одна открытая заявка на домен. Решение придёт вебхуком transfer.updated.

Запрос

{ "comment": "Переносим к другому регистратору, код — на ops@example.net" }

Попробовать в песочнице

Ответ 200

{ "id": "tr_4kQz9", "domain": "mybrand.io", "status": "open",
  "comment": "Переносим…", "reason": null, "created_at": "2026-11-17T10:00:00Z" }
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 пустой — корень домена.

Попробовать в песочнице

Ответ 200

{
  "domain": "mybrand.io",
  "records": [
    { "type": "a", "host": "", "value": "203.0.113.10", "mx_priority": null, "redirect_code": 301 },
    { "type": "mx", "host": "", "value": "mx.example.net", "mx_priority": 10, "redirect_code": 301 }
  ]
}
PUT /domains/{domain}/dns Заменить набор

Полная замена пачкой, до 100 записей: всё, чего нет в запросе, будет удалено. После записи — вебхук dns.changed.

Запрос

{ "records": [ { "type": "a", "host": "", "value": "203.0.113.10" } ] }

Попробовать в песочнице

POST /domains/{domain}/dns/templates Применить шаблон

Шаблоны: vercel, github_pages (нужен params.user), google_workspace, redirect (нужен params.url, params.code — 301 или 302). Записи шаблона сводятся с текущими: A, AAAA, CNAME и редирект на том же имени заменяются, MX и TXT дописываются. В ответе — итоговый набор.

Запрос

{ "template": "redirect", "params": { "url": "https://example.net", "code": "301" } }

Попробовать в песочнице

Серверы имён

NS домена и собственные дочерние серверы имён (ns1.<домен>).

PUT /domains/{domain}/nameservers Сменить NS

От 2 до 13 серверов имён. NS под самим доменом (ns1.<домен>) — только после того, как заведён дочерний сервер (ниже), иначе ns_missing_glue со списком недостающих. После смены — вебхук dns.changed.

Запрос

{ "nameservers": ["ns1.example.net", "ns2.example.net"] }

Попробовать в песочнице

Ответ 200

{ "domain": "mybrand.io", "nameservers": ["ns1.example.net", "ns2.example.net"], "error": null }
PATCH /domains/nameservers Сменить NS пачкой

До 50 доменов. Ошибка одного не отменяет остальные — error у элемента.

Запрос

{ "items": [ { "domain": "a.io", "nameservers": ["ns1.example.net", "ns2.example.net"] } ] }

Попробовать в песочнице

GET /domains/{domain}/nameserver-hosts Дочерние серверы

Хосты вида ns1.<домен> и их адреса в реестре.

Попробовать в песочнице

POST /domains/{domain}/nameserver-hosts Завести дочерний сервер

Имя ns1 или ns1.<домен> и 1–4 адреса IPv4/IPv6 из интернета. Не больше 6 на домен.

Запрос

{ "host": "ns1", "ips": ["203.0.113.53"] }

Попробовать в песочнице

PUT /domains/{domain}/nameserver-hosts/{host} Сменить адреса

Новый набор адресов заменяет старый.

Запрос

{ "ips": ["203.0.113.54", "2001:db8::53"] }

Попробовать в песочнице

DELETE /domains/{domain}/nameserver-hosts/{host} Удалить дочерний сервер

Пока на хост делегирован хоть один домен, реестр откажет — nameserver_host_in_use.

Попробовать в песочнице

Вебхуки

Подписки, журнал доставок, повтор и проверочный вызов.

GET /webhooks Подписки

Все адреса и события, на которые они подписаны. Адреса, заведённые в v1, получают только пять событий v1.

Попробовать в песочнице

POST /webhooks Подписаться

Пустой events — все события. Адрес — публичный, не локальный. Секрет для подписи показывается один раз, в ответе. Не больше 10 адресов. Адрес, заведённый тестовым ключом, получает только события песочницы; удалять адреса и менять им секрет можно только боевым ключом.

Запрос

{ "url": "https://example.net/hooks/regex", "events": ["order.completed", "domain.expiring"] }

Попробовать в песочнице

Ответ 200

{ "id": 7, "url": "https://example.net/hooks/regex", "api_version": "v2",
  "secret": "whsec_…", "events": ["order.completed", "domain.expiring"] }
DELETE /webhooks/{id} Отписаться

Доставки, стоящие в очереди, отменяются.

Попробовать в песочнице

POST /webhooks/{id}/test Проверочный вызов

Отправит событие webhook.test на этот адрес — проверить адрес и подпись. Подписка не нужна.

Попробовать в песочнице

POST /webhooks/{id}/secret Сменить секрет

Новый секрет подписи приходит один раз, в ответе. Старый перестаёт действовать сразу — обновите проверку подписи.

Попробовать в песочнице

GET /webhooks/{id}/deliveries Журнал доставок

Каждое событие: статус, сколько попыток, код ответа и ошибка.

ПараметрТипОписание
status string pending · success · failed
limit int До 200, по умолчанию 50
cursor string Курсор следующей страницы

Попробовать в песочнице

POST /webhooks/{id}/deliveries/{event_id}/retry Повторить доставку

Неудачная доставка снова встаёт в очередь с полным набором попыток. Повторить можно только failed.

Попробовать в песочнице

Платёжка USDT

Приём USDT TRC20 и BEP20 прямо на ваш кошелёк. Бесплатно: деньги клиента идут на ваш кошелёк, мы только следим за ним и сообщаем об оплате вебхуком payment.paid. Подключение — в кабинете: regexdomain.com/partner/payments, без проверки и ожидания. Клиент платит на отдельной странице Regex: сумма, адрес, QR. Каждому счёту — уникальная сумма с центами: по ней узнаётся платёж, поэтому клиент переводит её ровно. Ключом regex_test_… всё работает в песочнице, даже без подключения.

POST /payments Выставить счёт

Возвращает ссылку pay_url — отправьте на неё клиента. Сумма к переводу pay_amount = ваша цена + ваша надбавка из кабинета + уникальные центы. Без network при двух кошельках сеть выберет клиент на странице оплаты (до выбора network, wallet и pay_amount — null). Idempotency-Key не обязателен, но с ним повтор после обрыва вернёт тот же счёт.

ПараметрТипОписание
amount обязательный string Цена в USDT до центов, 1–100000
network string trc20 · bep20
order_id string Ваш номер заказа, до 128 символов
description string Что оплачивают — видно клиенту
return_url string https-адрес кнопки «Вернуться в магазин»
lifetime_minutes int Срок счёта, 10–180, по умолчанию 30

Запрос

{ "amount": "25.00", "network": "trc20", "order_id": "A-1042",
  "return_url": "https://shop.example/orders/A-1042" }

Попробовать в песочнице

Ответ 200

{ "id": "pay_Xk3vQ9mT2aLp", "status": "pending", "network": "trc20", "currency": "USDT",
  "wallet": "TQ…ваш кошелёк", "price": "25.00", "surcharge": "0.00", "pay_amount": "25.03",
  "pay_url": "https://pay.regexdomain.com/pay_Xk3vQ9mT2aLp", "order_id": "A-1042",
  "expires_at": "2026-11-20T18:30:00Z", "paid_at": null, "tx_hash": null, "sandbox": false }
GET /payments Счета

Новые сверху.

ПараметрТипОписание
status string pending · paid · expired · cancelled
order_id string Только счета этого заказа
limit int До 100, по умолчанию 50

Попробовать в песочнице

GET /payments/{id} Статус счёта

Бесплатно и без лимита на число счетов. paid — перевод подтверждён сетью, в ответе tx_hash и payer.

Попробовать в песочнице

Ответ 200

{ "id": "pay_Xk3vQ9mT2aLp", "status": "paid", "network": "trc20", "currency": "USDT",
  "wallet": "TQ…ваш кошелёк", "price": "25.00", "surcharge": "0.00", "pay_amount": "25.03",
  "pay_url": "https://pay.regexdomain.com/pay_Xk3vQ9mT2aLp", "order_id": "A-1042",
  "expires_at": "2026-11-20T18:30:00Z", "paid_at": null, "tx_hash": null, "sandbox": false }
POST /payments/{id}/cancel Отменить счёт

Только ожидающий. Перевод, который клиент успел отправить, не потеряется — он будет в кабинете среди не совпавших.

Попробовать в песочнице

POST /payments/{id}/simulate Песочница: оплатить

Только ключом regex_test_…: счёт песочницы становится paid, уходит вебхук payment.paid с sandbox: true.

Попробовать в песочнице

Служебные

Состояние сервиса и песочница.

GET /health Состояние

Без ключа. 200 — сервис отвечает.

Попробовать в песочнице

Ответ 200

{ "status": "ok", "time": "2026-11-16T09:20:00Z" }
POST /sandbox/reset Сбросить песочницу

Только для ключей regex_test_…: баланс снова $1000, тестовые домены, их метки, записи и заказы стираются.

Попробовать в песочнице

События вебхуков

Мы сами сообщаем, что произошло: не нужно опрашивать заказы и домены. Неудачная доставка повторяется до 7 раз — от 30 секунд до 3 часов.

СобытиеКогда приходит
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Проверочный вызов

Проверка подписи

Каждый вызов подписан секретом подписки: HMAC-SHA256 от строки timestamp.delivery.body. Подписи старше 5 минут отбрасывайте.

import hmac, hashlib, time

def verify(secret: str, headers, body: bytes) -> bool:
    ts = headers["X-Webhook-Timestamp"]
    if abs(time.time() - int(ts)) > 300:      # старше 5 минут — повтор
        return False
    to_sign = f"{ts}.{headers['X-Webhook-Delivery']}.".encode() + body
    expected = "sha256=" + hmac.new(secret.encode(), to_sign, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, headers["X-Webhook-Signature"])

Ошибки

Всегда один вид ответа. request_id пришлите в поддержку — найдём запрос за минуту.

{
  "error": {
    "code": "quote_expired",
    "message": "Котировке больше 10 минут.",
    "hint": "Запросите новую: POST /v2/quotes",
    "request_id": "req_5mQ1c8",
    "docs_url": "https://docs.regexdomain.com/v2/docs#err-quote_expired"
  }
}
КодHTTPЧто значит и что делать
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 в поддержку.

Рецепты

Готовые сценарии — из каких вызовов они складываются.

Витрина доменов за вечер

Поиск, цена, оплата — на вашем сайте, под вашим брендом.

  1. GET /domains/suggest — варианты по слову
  2. POST /quotes — закрепить цену в корзине
  3. POST /orders — оплата, ответ ждите вебхуком

Подключить домен к Vercel

Клиент купил домен — сайт открывается через минуту.

  1. POST /orders — регистрация
  2. POST /domains/{domain}/dns/templates — шаблон vercel
  3. dns.changed — показать клиенту «готово»

Продлевать всё, что истекает

Автосписаний нет: решение о продлении остаётся за вами.

  1. domain.expiring — за 30, 7 и 1 день
  2. GET /domains?status=expiring — собрать список
  3. POST /quotes + POST /orders с action renew — пачкой

Принять оплату USDT на сайте

Бесплатно, деньги — сразу на ваш кошелёк.

  1. POST /payments — счёт на заказ, клиент уходит на pay_url
  2. payment.paid — отметить заказ оплаченным
  3. payment.expired — снять бронь, если не оплатили

Сверка денег за месяц

Каждый цент виден: списания, возвраты, наценка.

  1. GET /account/transactions?from=…&to=…
  2. GET /orders?status=refunded — возвраты
  3. Сумма total по заказам = сумма charge в выписке

Переход с v1

v1 продолжает работать без срока — переходите, когда удобно. Ключи общие: тот же ключ работает и в v1, и в v2.

Было в v1Стало в v2
GET /v1/domains/search?name= (одно имя)POST /v2/domains/search — до 100 имён
POST /v1/domains/registerPOST /v2/quotes → POST /v2/orders (action register)
POST /v1/domains/{d}/renew — без защиты от повтораPOST /v2/orders (action renew) + Idempotency-Key
idempotency_key в телезаголовок Idempotency-Key у всех платных запросов
price_partner_usd · charged_usd (числа)price · markup · total (строки)
POST + DELETE /v1/domains/{d}/dns по однойPUT /v2/domains/{d}/dns пачкой + шаблоны
5 событий вебхуков15 событий, журнал доставок, повтор, тест
Тестовый ключ тратит деньгиПесочница: $1000 игровых
Лимит виден только по 429RateLimit-* в каждом ответе
Один вид ключа — всё или ничегоКлючи read / dns / full

Скоро

  • SDK для Python и TypeScript, коллекция Postman

Изменения и статус

Статус сервиса сейчас: проверяем… · JSON · подписаться на изменения (RSS / Atom)

· Платёжка USDT

  • Приём USDT TRC20 и BEP20 на ваш кошелёк: POST /payments, страница оплаты, вебхуки payment.paid и payment.expired.
  • Бесплатно; подключение — в кабинете, раздел «Платежи».

· Кабинет, библиотеки и инструменты

  • Кабинет партнёра на сайте: баланс, ключи с правами, журнал запросов, вебхуки, домены, выписка, команда.
  • Мастер «подключение за 5 минут» и «Попробовать» в документации — ключом песочницы.
  • OpenAPI 3.1, коллекция Postman, llms.txt; клиенты Python, TypeScript и PHP; утилита regex; MCP-сервер.
  • Ключи read / dns / full, срок жизни и ротация с 24 часами перекрытия.
  • Вебхуки: смена секрета, журнал доставок, повтор, тестовое событие; новые события.
  • Заявка на перенос домена: POST /domains/{domain}/transfer-requests.
  • Страница статуса GET /status.

· API v2: первый выпуск

  • Единый формат ошибок, Idempotency-Key, RateLimit-*, X-Request-Id, деньги строкой.
  • Котировки на 10 минут и заказы со статусом.
  • Песочница: $1000 игровых для ключей regex_test_….