Эта страница показана на языке вашего устройства.Открыть на английском

Разработчикам

Создавайте решения с Register.gy

Позвольте ИИ-ассистентам и вашим собственным приложениям проверять домены .gy и подключать их к сайтам. REST API, MCP-сервер для Claude, ChatGPT и Cursor, а также вход через OAuth. Бесплатно для каждого клиента Register.gy.

Обзор

Register.gy — аккредитованный регистратор доменов .gy. Платформа для разработчиков предоставляет те же инструменты, которыми клиенты пользуются в Личном кабинете, поэтому ассистент или приложение может:

  • Проверять доступность имён в зонах .gy, .com.gy, .co.gy, .net.gy и .org.gy, с ценой и ссылкой на регистрацию. Вход не нужен.
  • Получать список доменов клиента и читать их DNS-записи.
  • Подключать сайт: отправьте записи, которые показывает конструктор сайтов (Lovable, Bolt, Replit, v0, Netlify, Shopify…), получите предпросмотр, затем примените. Любое изменение можно отменить в течение 7 дней.
  • Проверять, что сайт работает: видимость в DNS и https.

Платформа намеренно никогда не меняет почтовые записи (MX) и NS-серверы, не переносит домены и не затрагивает платежи. Изменения на уровне реестра вносит команда Register.gy.

Базовый URL RESThttps://register.gy/wp-json/rgy/v1
MCP-серверhttps://register.gy/wp-json/rgy/v1/mcp
OpenAPIhttps://register.gy/wp-json/rgy/v1/openapi.json
Метаданные OAuthhttps://register.gy/.well-known/oauth-authorization-server
Сводка для ИИ-инструментовhttps://register.gy/llms.txt

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

1. Проверьте имя (без ключа)

curl "https://register.gy/wp-json/rgy/v1/availability?domain=mybakery.gy"

2. Создайте API-ключ

Войдите в Личный кабинет, откройте раздел API и ИИ-ассистенты и нажмите Создать API-ключ. Ключ показывается только один раз.

3. Получите список своих доменов

curl -H "Authorization: Bearer rgy_live_YOUR_KEY" https://register.gy/wp-json/rgy/v1/domains

4. Предпросмотр, затем подключение сайта

curl -X POST https://register.gy/wp-json/rgy/v1/domains/mybakery.gy/connect/preview \
  -H "Authorization: Bearer rgy_live_YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"records":[{"type":"A","name":"@","value":"185.158.133.1"},{"type":"TXT","name":"_lovable","value":"lovable_verify=…"}]}'

Если предпросмотр выглядит правильно, отправьте то же тело запроса на /connect/apply. Отменить можно через /connect/undo в течение 7 дней.

Подключение ИИ-ассистента

У Register.gy есть удалённый MCP-сервер (стандартный способ, которым ассистенты используют внешние инструменты). Ассистенты, поддерживающие вход, откроют окно Register.gy: клиент вводит свой email, набирает 6-значный код, который мы отправляем, и одобряет, что ассистенту разрешено делать.

Claude

Добавьте пользовательский коннектор с этим адресом, затем войдите:

https://register.gy/wp-json/rgy/v1/mcp

ChatGPT

Если ChatGPT позволяет добавить пользовательский коннектор или приложение (режим разработчика), используйте тот же адрес и выберите вход через OAuth:

https://register.gy/wp-json/rgy/v1/mcp

Claude Code

claude mcp add --transport http register-gy https://register.gy/wp-json/rgy/v1/mcp

Затем выполните /mcp в Claude Code, чтобы войти. Или обойдитесь без входа с помощью ключа: добавьте --header "Authorization: Bearer rgy_live_YOUR_KEY".

Cursor и другие MCP-клиенты

{
  "mcpServers": {
    "register-gy": {
      "url": "https://register.gy/wp-json/rgy/v1/mcp",
      "headers": { "Authorization": "Bearer rgy_live_YOUR_KEY" }
    }
  }
}

Клиенты с поддержкой OAuth могут не указывать headers и вместо этого войти.

Затем спросите, например: «Свободен ли mybakery.gy?» или «Подключи мой сайт на Lovable к mybakery.gy.» Ассистент покажет запланированные изменения и спросит разрешения, прежде чем их применить.

Публичный эндпоинт только для поиска (без входа): https://register.gy/wp-json/rgy/v1/mcp/public

Аутентификация

OAuth 2.1 (рекомендуется для ассистентов и приложений, которыми пользуются другие люди)

  • Поток authorization code с PKCE (только S256). Публичные и конфиденциальные клиенты.
  • Динамическая регистрация клиентов (RFC 7591) по адресу https://register.gy/oauth/register. Redirect URI должны использовать https или http на localhost.
  • Обнаружение: /.well-known/oauth-authorization-server (RFC 8414) и /.well-known/oauth-protected-resource (RFC 9728). На неаутентифицированные запросы эндпоинт MCP отвечает кодом 401 и заголовком WWW-Authenticate, указывающим на метаданные ресурса.
  • Токены доступа действуют 1 час, токены обновления — 30 дней и меняются при каждом использовании. Повторное использование старого токена обновления разрывает всё подключение.
  • Отзыв: https://register.gy/oauth/revoke (RFC 7009). Клиенты также могут отключать приложения в Личном кабинете.
Область доступаРазрешает
domains:readSee your .gy domains and their DNS records
websites:writeConnect your websites (change website records only, with 7-day undo)

API-ключи (ваши собственные скрипты и инструменты)

Создайте до 5 ключей в Личном кабинете. Передавайте их как Authorization: Bearer rgy_live_… или X-API-Key: rgy_live_…. У ключей есть обе области доступа. Они хранятся в виде хешей, а владельцу приходит письмо при создании каждого ключа.

MCP-сервер

Транспорт Streamable HTTP, ответы в JSON (без потока событий), версии протокола 2025-06-18, 2025-03-26, 2024-11-05.

ИнструментЧто делаетИзменяет данные?
search_domainCheck whether a .gy domain (.gy, .com.gy, .co.gy, .net.gy or .org.gy) is available at Register.gy, with the yearly price and a link to register it.Нет
notify_when_registration_reopensUse only when search_domain says new .gy registrations are paused. Adds the user to Register.gy's notify list: Register.gy checks the domain again and emails them a link to register it as soon as registration reopens (usually within about an hour). Only call with the user's permission and their own email address.Да, после подтверждения
list_my_domainsList the user's .gy domains at Register.gy, with expiry date and whether each can be connected to a website now.Нет
get_dns_recordsShow the current DNS records of one of the user's .gy domains.Нет
connect_websitePoint one of the user's .gy domains at their website by setting the DNS records their website builder (Lovable, Bolt, Replit, v0/Vercel, Netlify, Webflow, Shopify…) shows on its custom-domain screen. Use the builder's real values, never guesses. ALWAYS call with apply=false first and show the user the preview; call again with apply=true only after the user clearly confirms. Email (MX) and nameserver records are never changed. The change can be undone for 7 days.Да, после подтверждения
check_liveCheck whether the website records of a .gy domain are visible on the internet and whether https works yet.Нет
undo_last_changePut back the website records that were in place before the last connect_website change on this domain (available for 7 days). Ask the user first.Да, после подтверждения

REST API

Базовый URL https://register.gy/wp-json/rgy/v1. JSON на входе, JSON на выходе. Ошибки выглядят так: {"error":{"code":"not_found","message":"…"}}.

МетодПутьОписаниеАвторизация
GET/availabilityIs a .gy domain available?Нет
GET/statusAre .gy registrations open or paused right now?Нет
POST/notifyWhile registrations are paused: email me when they reopenНет
GET/healthService status for uptime monitorsНет
GET/meWho this key belongs toКлюч или токен
GET/domainsYour .gy domainsКлюч или токен
GET/domains/{domain}One domainКлюч или токен
GET/domains/{domain}/recordsCurrent DNS recordsКлюч или токен
POST/domains/{domain}/connect/previewPreview connecting a website (changes nothing)Ключ или токен
POST/domains/{domain}/connect/applyConnect a website (after the user confirms the preview)Ключ или токен
POST/domains/{domain}/connect/undoUndo the last connectКлюч или токен
GET/domains/{domain}/liveIs the site live (DNS + https)?Ключ или токен
POST/mcpMCP endpoint for AI assistants (JSON-RPC 2.0, Streamable HTTP)Ключ или токен

Тело запроса на подключение

Либо список записей, либо исходный текст, который показывает ваш конструктор (таблица или список). Настраиваются только A, AAAA, CNAME (ALIAS) и TXT; всё остальное перечисляется в skipped с указанием причины.

{
  "records": [
    { "type": "A", "name": "@", "value": "185.158.133.1" },
    { "type": "CNAME", "name": "www", "value": "mysite.netlify.app" }
  ]
}

Лимиты и ошибки

Запросы300 на ключ или подключение каждые 10 минут
Изменения60 каждые 10 минут на клиента (общий лимит с Личным кабинетом)
Проверка доступности30 проверок в минуту с одного IP-адреса
Записей за одно подключение15
СтатусЗначение
400Некорректный запрос (в сообщении сказано, что исправить)
401Ключ или токен отсутствует, недействителен или истёк
403Запрещено (например, подключение только для чтения пытается изменить записи или домен управляется нашей командой)
404Нет в этом аккаунте или неизвестный эндпоинт
429Слишком много запросов; подождите и повторите
503Зависимость (DNS или проверка доступности) не отвечает; повторите позже

Безопасность

  • Ключи и токены хранятся только в виде хешей SHA-256. Коды входа одноразовые, истекают через 10 минут и ограничены по частоте запросов.
  • Каждый ключ или подключение видит только домены клиента, который его создал.
  • Каждое изменение через API записывается в журнал и может быть отменено в течение 7 дней. Записи сайта настраиваются в режиме «только DNS», чтобы конструкторы могли выпустить свои сертификаты https.
  • Нашли проблему безопасности? Напишите на [email protected], указав в теме «Security». Пожалуйста, дайте нам возможность исправить её, прежде чем рассказывать другим.

История изменений

  • 8 октября 2026 г. Вход через OAuth 2.1 (PKCE, динамическая регистрация клиентов, ротация токенов обновления), подключённые приложения в Личном кабинете, публичный MCP-эндпоинт только для поиска.
  • 8 октября 2026 г. Запущены REST API и MCP-сервер: доступность, домены, записи, предпросмотр/применение/отмена подключения, проверка работы сайта. API-ключи в Личном кабинете.

Поддержка и условия

Вопросы, идеи или предложения о партнёрстве: [email protected] или +592-623-1721.

Использование API регулируется нашей политикой конфиденциальности. Отдельные условия API находятся в доработке.