{"openapi":"3.1.0","info":{"title":"Regex API","description":"HTTP API **Regex** для программной регистрации доменов.\n\nАвторизация: `Authorization: Bearer <key>`. Формат — JSON. Валюта — USD.\n\nКлюч выдаётся в Telegram-боте: раздел «API-интеграция» → «Создать кабинет». Там же баланс, выпуск и отзыв ключей.","version":"1.0.0"},"paths":{"/v1/health":{"get":{"tags":["Служебные"],"summary":"Проверка живости","description":"Простой health-check. Всегда возвращает 200, пока процесс жив. Используется nginx/Docker для liveness-проб.","operationId":"health_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}},"/v1/account":{"get":{"tags":["Аккаунт"],"summary":"Информация об аккаунте","description":"Возвращает баланс (available/reserved), тариф, дефолтные NS и лимиты партнёра. Баланс — снимок на момент запроса; блокировки строки здесь нет (это метод чтения, не изменения).","operationId":"get_account_v1_account_get","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/zones":{"get":{"tags":["Зоны и цены"],"summary":"Список зон и цен","description":"Все поддерживаемые TLD с ценами регистрации и продления «для партнёра» (себестоимость + наценка). Читается из внутреннего кэша цен, обновляемого фоном раз в час — не бьёт по внешнему API на каждый запрос.","operationId":"list_zones_v1_zones_get","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZonesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/domains/search":{"get":{"tags":["Подбор домена"],"summary":"Проверка доступности и цены","description":"Проверяет, свободен ли домен, и возвращает цену регистрации и продления «для партнёра» (с уже применённой наценкой). Ответ `available=false` — домен занят или недоступен для регистрации.","operationId":"search_domain_v1_domains_search_get","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","description":"Полное имя домена, например `example.com`","title":"Name"},"description":"Полное имя домена, например `example.com`"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainSearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/domains/register":{"post":{"tags":["Регистрация"],"summary":"Регистрация доменов (пакет, идемпотентно)","description":"Пакетная регистрация до 50 доменов за один запрос. Порядок обработки одного элемента: **проверка идемпотентности → расчёт цены → резерв средств (`available → reserved`) → создание заказа → регистрация → финальное списание** (или **возврат резерва** при сбое). Повтор запроса с тем же `idempotency_key` вернёт прежний результат без второй регистрации. Ошибка на одном домене не отменяет остальные — смотри `results[i].error_code`.","operationId":"register_domains_v1_domains_register_post","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainRegisterRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainRegisterResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/domains/nameservers":{"patch":{"tags":["Nameservers"],"summary":"Смена NS (пакет)","description":"Пакетная смена NS-серверов до 50 доменов за один запрос. Домен должен принадлежать партнёру (быть зарегистрирован ранее через этот же API). Ошибка на одном домене не отменяет остальные.\n\nNS под самим доменом (`ns1.<домен>`) должны быть заранее заведены как дочерние серверы имён (`POST /domains/{domain}/nameserver-hosts`). Если какого-то нет — элемент сразу получает `status=failed` и `error_code=ns_missing_glue`, в `error_message` перечислены недостающие хосты.","operationId":"update_nameservers_v1_domains_nameservers_patch","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NameserversUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NameserversUpdateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/domains/{domain}":{"get":{"tags":["Мои домены"],"summary":"Информация о домене","description":"Возвращает актуальный статус, срок действия и NS-серверы одного домена партнёра. Домен должен быть зарегистрирован через этот API (иначе 404 `domain_not_found`).","operationId":"get_domain_v1_domains__domain__get","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","description":"Полное имя домена","title":"Domain"},"description":"Полное имя домена"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainInfoResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/domains":{"get":{"tags":["Мои домены"],"summary":"Список доменов партнёра","description":"Возвращает домены партнёра со статусом `registered` с пагинацией по cursor. Первая страница — без параметра `cursor`; в ответе поле `next_cursor` подставляется в следующий запрос.","operationId":"list_domains_v1_domains_get","parameters":[{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"description":"Cursor следующей страницы (order_id).","title":"Cursor"},"description":"Cursor следующей страницы (order_id)."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Размер страницы.","default":50,"title":"Limit"},"description":"Размер страницы."},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/domains/{domain}/renew":{"post":{"tags":["Регистрация"],"summary":"Продление домена","description":"Продлевает домен на 1..10 лет. Тот же холд/чардж/рефанд, что и у регистрации — при сбое возврат резерва автоматический.","operationId":"renew_domain_v1_domains__domain__renew_post","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","description":"Полное имя домена","title":"Domain"},"description":"Полное имя домена"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainRenewRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainRenewResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/domains/{domain}/dns":{"get":{"tags":["DNS-записи"],"summary":"Список DNS-записей","operationId":"list_dns_v1_domains__domain__dns_get","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","description":"Полное имя домена","title":"Domain"},"description":"Полное имя домена"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DnsListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["DNS-записи"],"summary":"Полная замена DNS-записей","description":"Ставит DNS-записи домена ровно в присланный набор — предыдущие записи стираются. Используй, когда партнёр держит финальное состояние зоны у себя.","operationId":"replace_dns_v1_domains__domain__dns_put","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","description":"Полное имя домена","title":"Domain"},"description":"Полное имя домена"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DnsReplaceRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DnsReplaceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["DNS-записи"],"summary":"Добавить одну DNS-запись","description":"Добавляет одну запись к существующим. Для `type=forward` автоматически проверяет дубли, чтобы не плодить одинаковые редиректы.","operationId":"add_dns_v1_domains__domain__dns_post","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","description":"Полное имя домена","title":"Domain"},"description":"Полное имя домена"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DnsRecordSchema"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DnsAddResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["DNS-записи"],"summary":"Удалить одну DNS-запись","description":"Удаляет запись, точно совпадающую по `type`, `host`, `value`. Возвращает количество удалённых (обычно 0 или 1).","operationId":"delete_dns_v1_domains__domain__dns_delete","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","description":"Полное имя домена","title":"Domain"},"description":"Полное имя домена"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DnsRecordSchema"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DnsDeleteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/domains/{domain}/nameserver-hosts":{"get":{"tags":["Серверы имён"],"summary":"Список дочерних серверов имён","description":"Хосты вида `ns1.<домен>`, заведённые в реестре для этого домена, с их адресами (glue-записи). Читается у реестра при каждом запросе (кэш до минуты, сбрасывается вашими же правками).","operationId":"list_nameserver_hosts_v1_domains__domain__nameserver_hosts_get","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","description":"Полное имя домена","title":"Domain"},"description":"Полное имя домена"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NameserverHostListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Серверы имён"],"summary":"Завести дочерний сервер имён","description":"Заводит в реестре хост под доменом (`ns1.<домен>`) с 1–4 адресами — без этого сменить домену NS на `ns1.<домен>` нельзя. Не больше 6 хостов на домен. Если домен стоит на наших NS, A/AAAA хоста сами появятся в его зоне (`zone_records=updated`). Делегирование домена не меняется: NS переключаются отдельно, `PATCH /domains/nameservers`.","operationId":"create_nameserver_host_v1_domains__domain__nameserver_hosts_post","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","description":"Полное имя домена","title":"Domain"},"description":"Полное имя домена"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NameserverHostCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NameserverHostResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/domains/{domain}/nameserver-hosts/{host}":{"put":{"tags":["Серверы имён"],"summary":"Сменить адреса дочернего сервера имён","description":"Заменяет адреса хоста целиком. Записи в нашей зоне — следом.","operationId":"update_nameserver_host_v1_domains__domain__nameserver_hosts__host__put","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","description":"Полное имя домена","title":"Domain"},"description":"Полное имя домена"},{"name":"host","in":"path","required":true,"schema":{"type":"string","description":"Метка (`ns1`) или полное имя (`ns1.example.com`)","title":"Host"},"description":"Метка (`ns1`) или полное имя (`ns1.example.com`)"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NameserverHostUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NameserverHostResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Серверы имён"],"summary":"Удалить дочерний сервер имён","description":"Удаляет хост из реестра и его A/AAAA из нашей зоны. Пока на хост делегирован хоть один домен, реестр откажет — `409 nameserver_host_in_use`.","operationId":"delete_nameserver_host_v1_domains__domain__nameserver_hosts__host__delete","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","description":"Полное имя домена","title":"Domain"},"description":"Полное имя домена"},{"name":"host","in":"path","required":true,"schema":{"type":"string","description":"Метка (`ns1`) или полное имя (`ns1.example.com`)","title":"Host"},"description":"Метка (`ns1`) или полное имя (`ns1.example.com`)"},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NameserverHostResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/webhooks":{"get":{"tags":["Вебхуки"],"summary":"Список вебхуков","operationId":"list_webhooks_v1_webhooks_get","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Вебхуки"],"summary":"Создать вебхук","description":"Создаёт endpoint и генерирует секрет подписи. **Секрет возвращается ровно один раз — сохрани его.** Восстановить потом нельзя (только пересоздать вебхук).","operationId":"create_webhook_v1_webhooks_post","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookCreateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/webhooks/{webhook_id}":{"delete":{"tags":["Вебхуки"],"summary":"Удалить вебхук","operationId":"delete_webhook_v1_webhooks__webhook_id__delete","parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"title":"Webhook Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AccountBalance":{"properties":{"available":{"type":"string","title":"Available"},"reserved":{"type":"string","title":"Reserved"},"currency":{"type":"string","title":"Currency","default":"USD"}},"type":"object","required":["available","reserved"],"title":"AccountBalance","description":"Баланс в валюте партнёра (сейчас всегда USD)."},"AccountLimits":{"properties":{"rate_limit_per_second":{"type":"integer","title":"Rate Limit Per Second"},"bulk_register_max":{"type":"integer","title":"Bulk Register Max","description":"Максимум доменов в одном /domains/register","default":50},"bulk_nameservers_max":{"type":"integer","title":"Bulk Nameservers Max","description":"Максимум доменов в одном /domains/nameservers","default":50}},"type":"object","required":["rate_limit_per_second"],"title":"AccountLimits","description":"Лимиты, применимые к запросам этого партнёра."},"AccountResponse":{"properties":{"partner_id":{"type":"integer","title":"Partner Id"},"name":{"type":"string","title":"Name"},"status":{"type":"string","enum":["active","suspended"],"title":"Status"},"tier":{"type":"string","enum":["basic","prime"],"title":"Tier"},"ns_mode":{"type":"string","enum":["auto","manual"],"title":"Ns Mode"},"default_nameservers":{"items":{"type":"string"},"type":"array","title":"Default Nameservers"},"resale_percent":{"type":"string","title":"Resale Percent","default":"0"},"balance":{"$ref":"#/components/schemas/AccountBalance"},"limits":{"$ref":"#/components/schemas/AccountLimits"}},"type":"object","required":["partner_id","name","status","tier","ns_mode","default_nameservers","balance","limits"],"title":"AccountResponse","description":"Ответ GET /account."},"DnsAddResponse":{"properties":{"domain":{"type":"string","title":"Domain"},"record":{"$ref":"#/components/schemas/DnsRecordSchema"}},"type":"object","required":["domain","record"],"title":"DnsAddResponse"},"DnsDeleteResponse":{"properties":{"domain":{"type":"string","title":"Domain"},"removed":{"type":"integer","title":"Removed"}},"type":"object","required":["domain","removed"],"title":"DnsDeleteResponse"},"DnsListResponse":{"properties":{"domain":{"type":"string","title":"Domain"},"records":{"items":{"$ref":"#/components/schemas/DnsRecordSchema"},"type":"array","title":"Records"}},"type":"object","required":["domain","records"],"title":"DnsListResponse"},"DnsRecordSchema":{"properties":{"type":{"type":"string","enum":["a","aaaa","cname","mx","txt","ns","srv","caa","forward"],"title":"Type"},"value":{"type":"string","title":"Value"},"host":{"type":"string","title":"Host","default":""},"mx_priority":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Mx Priority"},"redirect_code":{"type":"integer","title":"Redirect Code","description":"Только для type=forward: 301 (permanent) или 302 (temporary).","default":301}},"type":"object","required":["type","value"],"title":"DnsRecordSchema"},"DnsReplaceRequest":{"properties":{"records":{"items":{"$ref":"#/components/schemas/DnsRecordSchema"},"type":"array","maxItems":100,"title":"Records"}},"type":"object","required":["records"],"title":"DnsReplaceRequest"},"DnsReplaceResponse":{"properties":{"domain":{"type":"string","title":"Domain"},"records":{"items":{"$ref":"#/components/schemas/DnsRecordSchema"},"type":"array","title":"Records"}},"type":"object","required":["domain","records"],"title":"DnsReplaceResponse"},"DomainInfoResponse":{"properties":{"domain":{"type":"string","title":"Domain"},"status":{"type":"string","title":"Status"},"nameservers":{"items":{"type":"string"},"type":"array","title":"Nameservers"},"registered_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Registered At"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"auto_renew":{"type":"boolean","title":"Auto Renew","default":false},"whois_privacy":{"type":"boolean","title":"Whois Privacy","default":false},"ns_mode":{"type":"string","enum":["auto","manual"],"title":"Ns Mode"},"registrar_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registrar Status","description":"Нейтральный статус в терминах API ('active', 'transfer_locked', 'contact_verification_required', …)."}},"type":"object","required":["domain","status","nameservers","ns_mode"],"title":"DomainInfoResponse"},"DomainListItemResponse":{"properties":{"order_id":{"type":"integer","title":"Order Id"},"domain":{"type":"string","title":"Domain"},"registered_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Registered At"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"ns_mode":{"type":"string","enum":["auto","manual"],"title":"Ns Mode"},"nameservers":{"items":{"type":"string"},"type":"array","title":"Nameservers"}},"type":"object","required":["order_id","domain","ns_mode","nameservers"],"title":"DomainListItemResponse"},"DomainListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/DomainListItemResponse"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Next Cursor","description":"Cursor следующей страницы (передать в `?cursor=`). `null` — это последняя страница."}},"type":"object","required":["items"],"title":"DomainListResponse"},"DomainRegisterItem":{"properties":{"domain":{"type":"string","title":"Domain","description":"Полное имя домена"},"idempotency_key":{"type":"string","maxLength":128,"minLength":8,"title":"Idempotency Key","description":"Уникальный ключ на партнёра. Повтор с тем же ключом гарантированно вернёт предыдущий результат без второй регистрации."},"duration_years":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Duration Years","description":"Срок регистрации, лет.","default":1},"nameservers":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":13,"minItems":2},{"type":"null"}],"title":"Nameservers","description":"NS для домена (2..13). Пусто/None = дефолты партнёра."},"ns_mode":{"anyOf":[{"type":"string","enum":["auto","manual"]},{"type":"null"}],"title":"Ns Mode","description":"Переопределить ns_mode партнёра для этого заказа."}},"type":"object","required":["domain","idempotency_key"],"title":"DomainRegisterItem","description":"Одна позиция batch-запроса регистрации."},"DomainRegisterRequest":{"properties":{"domains":{"items":{"$ref":"#/components/schemas/DomainRegisterItem"},"type":"array","maxItems":50,"minItems":1,"title":"Domains"}},"type":"object","required":["domains"],"title":"DomainRegisterRequest","description":"Тело POST /domains/register."},"DomainRegisterResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/DomainRegisterResultItem"},"type":"array","title":"Results"},"balance":{"$ref":"#/components/schemas/AccountBalance"}},"type":"object","required":["results","balance"],"title":"DomainRegisterResponse","description":"Тело ответа POST /domains/register."},"DomainRegisterResultItem":{"properties":{"domain":{"type":"string","title":"Domain"},"idempotency_key":{"type":"string","title":"Idempotency Key"},"status":{"type":"string","enum":["registered","failed","pending","refunded"],"title":"Status"},"order_id":{"type":"integer","title":"Order Id"},"price_partner_usd":{"type":"string","title":"Price Partner Usd","description":"Наша цена — то, что остаётся у нас"},"resale_profit_usd":{"type":"string","title":"Resale Profit Usd","description":"Ваша наценка — ушла в кошелёк прибыли","default":"0"},"charged_usd":{"type":"string","title":"Charged Usd","description":"Списано с баланса API = цена + наценка","default":"0"},"nameservers":{"items":{"type":"string"},"type":"array","title":"Nameservers"},"ns_mode":{"type":"string","enum":["auto","manual"],"title":"Ns Mode"},"registered_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Registered At"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"idempotent_replay":{"type":"boolean","title":"Idempotent Replay","default":false},"error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Code"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"}},"type":"object","required":["domain","idempotency_key","status","order_id","price_partner_usd","nameservers","ns_mode"],"title":"DomainRegisterResultItem","description":"Ответ по одному домену из batch'a."},"DomainRenewRequest":{"properties":{"duration_years":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Duration Years","description":"Срок продления в годах.","default":1}},"type":"object","title":"DomainRenewRequest"},"DomainRenewResponse":{"properties":{"domain":{"type":"string","title":"Domain"},"order_id":{"type":"integer","title":"Order Id"},"status":{"type":"string","enum":["renewed","failed"],"title":"Status"},"duration_years":{"type":"integer","title":"Duration Years"},"price_partner_usd":{"type":"string","title":"Price Partner Usd","description":"Наша цена — то, что остаётся у нас"},"resale_profit_usd":{"type":"string","title":"Resale Profit Usd","description":"Ваша наценка — ушла в кошелёк прибыли","default":"0"},"charged_usd":{"type":"string","title":"Charged Usd","description":"Списано с баланса API = цена + наценка","default":"0"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Code"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"balance":{"$ref":"#/components/schemas/AccountBalance"}},"type":"object","required":["domain","order_id","status","duration_years","price_partner_usd","balance"],"title":"DomainRenewResponse"},"DomainSearchResponse":{"properties":{"domain":{"type":"string","title":"Domain"},"available":{"type":"boolean","title":"Available"},"is_premium":{"type":"boolean","title":"Is Premium","default":false},"registration_usd":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registration Usd","description":"Сколько спишется с вашего баланса"},"renewal_usd":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Renewal Usd"},"registration_resale_usd":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registration Resale Usd","description":"Цена для вашего клиента — с вашей наценкой из кабинета"},"renewal_resale_usd":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Renewal Resale Usd"},"currency":{"type":"string","title":"Currency","default":"USD"}},"type":"object","required":["domain","available"],"title":"DomainSearchResponse","description":"Ответ GET /domains/search."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthResponse":{"properties":{"status":{"type":"string","const":"ok","title":"Status","default":"ok"},"api_version":{"type":"string","title":"Api Version"},"time":{"type":"string","format":"date-time","title":"Time"}},"type":"object","required":["api_version","time"],"title":"HealthResponse","description":"Ответ GET /health — минимальный status-check."},"NameserverHostCreateRequest":{"properties":{"host":{"type":"string","title":"Host","description":"Метка (`ns1`) или полное имя (`ns1.example.com`). Хост — строго под этим доменом.","examples":["ns1"]},"ips":{"items":{"type":"string"},"type":"array","maxItems":16,"minItems":1,"title":"Ips","description":"1–4 публичных адреса. Частные сети и loopback не принимаются.","examples":[["203.0.113.10"]]}},"type":"object","required":["host","ips"],"title":"NameserverHostCreateRequest"},"NameserverHostListResponse":{"properties":{"domain":{"type":"string","title":"Domain"},"hosts":{"items":{"$ref":"#/components/schemas/NameserverHostSchema"},"type":"array","title":"Hosts"}},"type":"object","required":["domain","hosts"],"title":"NameserverHostListResponse"},"NameserverHostResponse":{"properties":{"domain":{"type":"string","title":"Domain"},"host":{"$ref":"#/components/schemas/NameserverHostSchema"},"zone_records":{"type":"string","enum":["updated","skipped","failed"],"title":"Zone Records","description":"A/AAAA этого хоста в DNS-зоне домена. `updated` — домен на наших NS, записи приведены к адресам хоста (при удалении — убраны); `skipped` — домен на других NS, записи ставьте у своего DNS-провайдера; `failed` — хост в реестре изменён, а записи в зоне — нет, поставьте их через `/domains/{domain}/dns`."}},"type":"object","required":["domain","host","zone_records"],"title":"NameserverHostResponse"},"NameserverHostSchema":{"properties":{"host":{"type":"string","title":"Host","description":"Полное имя хоста, например `ns1.example.com`."},"ips":{"items":{"type":"string"},"type":"array","title":"Ips","description":"Адреса хоста в реестре (IPv4 и/или IPv6)."}},"type":"object","required":["host","ips"],"title":"NameserverHostSchema"},"NameserverHostUpdateRequest":{"properties":{"ips":{"items":{"type":"string"},"type":"array","maxItems":16,"minItems":1,"title":"Ips","description":"Новый набор адресов целиком: прежние заменяются.","examples":[["203.0.113.10","2001:db8::10"]]}},"type":"object","required":["ips"],"title":"NameserverHostUpdateRequest"},"NameserversUpdateItem":{"properties":{"domain":{"type":"string","title":"Domain"},"nameservers":{"items":{"type":"string"},"type":"array","maxItems":13,"minItems":2,"title":"Nameservers"}},"type":"object","required":["domain","nameservers"],"title":"NameserversUpdateItem"},"NameserversUpdateRequest":{"properties":{"domains":{"items":{"$ref":"#/components/schemas/NameserversUpdateItem"},"type":"array","maxItems":50,"minItems":1,"title":"Domains"}},"type":"object","required":["domains"],"title":"NameserversUpdateRequest"},"NameserversUpdateResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/NameserversUpdateResultItem"},"type":"array","title":"Results"}},"type":"object","required":["results"],"title":"NameserversUpdateResponse"},"NameserversUpdateResultItem":{"properties":{"domain":{"type":"string","title":"Domain"},"status":{"type":"string","enum":["updated","failed"],"title":"Status"},"nameservers":{"items":{"type":"string"},"type":"array","title":"Nameservers"},"error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Code"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"}},"type":"object","required":["domain","status","nameservers"],"title":"NameserversUpdateResultItem"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"WebhookCreateRequest":{"properties":{"url":{"type":"string","maxLength":1024,"minLength":8,"title":"Url","description":"HTTPS-URL, куда POST'ить события."},"events":{"items":{"type":"string","enum":["domain.registered","domain.failed","domain.expiring","domain.abuse_flagged","balance.low"]},"type":"array","title":"Events","description":"Подписки. Пустой список = все события."},"label":{"type":"string","maxLength":64,"title":"Label","default":""}},"type":"object","required":["url"],"title":"WebhookCreateRequest"},"WebhookListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/WebhookResponse"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"WebhookListResponse"},"WebhookResponse":{"properties":{"id":{"type":"integer","title":"Id"},"url":{"type":"string","title":"Url"},"events":{"items":{"type":"string"},"type":"array","title":"Events"},"label":{"type":"string","title":"Label"},"active":{"type":"boolean","title":"Active"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"secret":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Secret","description":"Секрет вебхука для проверки подписи. Показывается ОДИН раз при создании и никогда после."}},"type":"object","required":["id","url","events","label","active","created_at"],"title":"WebhookResponse"},"ZonePrice":{"properties":{"tld":{"type":"string","title":"Tld","description":"TLD без ведущей точки, lowercase"},"registration_usd":{"type":"string","title":"Registration Usd","description":"Сколько спишется с вашего баланса"},"renewal_usd":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Renewal Usd"},"registration_resale_usd":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registration Resale Usd","description":"Цена для вашего клиента — с вашей наценкой из кабинета"},"renewal_resale_usd":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Renewal Resale Usd"},"currency":{"type":"string","title":"Currency","default":"USD"}},"type":"object","required":["tld","registration_usd"],"title":"ZonePrice","description":"Цена одного TLD для партнёра (уже с наценкой, USD/год)."},"ZonesResponse":{"properties":{"zones":{"items":{"$ref":"#/components/schemas/ZonePrice"},"type":"array","title":"Zones"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["zones","count"],"title":"ZonesResponse","description":"Ответ GET /zones."}}},"tags":[{"name":"Служебные","description":"Проверка доступности API."},{"name":"Аккаунт","description":"Баланс, лимиты и данные партнёра."},{"name":"Зоны и цены","description":"Какие зоны продаём и почём."},{"name":"Подбор домена","description":"Проверка занятости и цена конкретного имени."},{"name":"Регистрация","description":"Покупка и продление. Списания идут с баланса API."},{"name":"Мои домены","description":"Список и карточка домена, купленного через API."},{"name":"Nameservers","description":"Смена NS пакетом — до 50 доменов за запрос."},{"name":"Серверы имён","description":"Свои серверы имён под своим доменом — `ns1.example.com`, `ns2.example.com` (дочерние NS, glue-записи). Реестр должен знать их адреса заранее, иначе смена NS на них не пройдёт.\n\n**Порядок:**\n\n1. Завести хосты: `POST /v1/domains/{domain}/nameserver-hosts` — по запросу на хост.\n2. Поднять DNS на своих серверах: они должны отвечать за зону домена (и за сами `ns1`/`ns2`).\n3. Сменить NS: `PATCH /v1/domains/nameservers`. Без шага 1 ответ — `ns_missing_glue`.\n\n```bash\ncurl -X POST https://api.regexdomain.com/v1/domains/example.com/nameserver-hosts \\\n  -H 'Authorization: Bearer <key>' -H 'Content-Type: application/json' \\\n  -d '{\"host\": \"ns1\", \"ips\": [\"203.0.113.10\"]}'\n\ncurl -X PATCH https://api.regexdomain.com/v1/domains/nameservers \\\n  -H 'Authorization: Bearer <key>' -H 'Content-Type: application/json' \\\n  -d '{\"domains\": [{\"domain\": \"example.com\", \"nameservers\": [\"ns1.example.com\", \"ns2.example.com\"]}]}'\n```\n\nУдалить хост можно, только когда на него не делегирован ни один домен."},{"name":"DNS-записи","description":"Записи в наших NS: просмотр, замена, добавление, удаление."},{"name":"Вебхуки","description":"Уведомления о событиях на вашем эндпоинте."}],"x-tagGroups":[{"name":"Начало работы","tags":["Служебные","Аккаунт"]},{"name":"Домены","tags":["Зоны и цены","Подбор домена","Регистрация","Мои домены"]},{"name":"DNS","tags":["Nameservers","Серверы имён","DNS-записи"]},{"name":"События","tags":["Вебхуки"]}]}