Обзор
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 REST | https://register.gy/wp-json/rgy/v1 |
|---|---|
| MCP-сервер | https://register.gy/wp-json/rgy/v1/mcp |
| OpenAPI | https://register.gy/wp-json/rgy/v1/openapi.json |
| Метаданные OAuth | https://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/mcpChatGPT
Если ChatGPT позволяет добавить пользовательский коннектор или приложение (режим разработчика), используйте тот же адрес и выберите вход через OAuth:
https://register.gy/wp-json/rgy/v1/mcpClaude 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:read | See your .gy domains and their DNS records |
websites:write | Connect 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_domain | Check 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_reopens | Use 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_domains | List the user's .gy domains at Register.gy, with expiry date and whether each can be connected to a website now. | Нет |
get_dns_records | Show the current DNS records of one of the user's .gy domains. | Нет |
connect_website | Point 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_live | Check whether the website records of a .gy domain are visible on the internet and whether https works yet. | Нет |
undo_last_change | Put 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 | /availability | Is a .gy domain available? | Нет |
| GET | /status | Are .gy registrations open or paused right now? | Нет |
| POST | /notify | While registrations are paused: email me when they reopen | Нет |
| GET | /health | Service status for uptime monitors | Нет |
| GET | /me | Who this key belongs to | Ключ или токен |
| GET | /domains | Your .gy domains | Ключ или токен |
| GET | /domains/{domain} | One domain | Ключ или токен |
| GET | /domains/{domain}/records | Current DNS records | Ключ или токен |
| POST | /domains/{domain}/connect/preview | Preview connecting a website (changes nothing) | Ключ или токен |
| POST | /domains/{domain}/connect/apply | Connect a website (after the user confirms the preview) | Ключ или токен |
| POST | /domains/{domain}/connect/undo | Undo the last connect | Ключ или токен |
| GET | /domains/{domain}/live | Is the site live (DNS + https)? | Ключ или токен |
| POST | /mcp | MCP 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 находятся в доработке.