hostinger-api-mcp
Сервер Model Context Protocol (MCP) для Hostinger API.
Быстрый старт: размещённый удалённый сервер
Если вы не хотите ничего устанавливать или запускать локально, подключитесь напрямую к размещённому серверу MCP от Hostinger:
https://mcp.hostinger.com
Claude Code
claude mcp add --transport http hostinger https://mcp.hostinger.com
Откроется окно браузера для авторизации через OAuth. После подтверждения в вашей сессии станут доступны все перечисленные ниже инструменты.
Другие клиенты, совместимые с MCP
Добавьте https://mcp.hostinger.com в конфигурацию клиента как удалённый сервер MCP с транспортом Streamable HTTP и завершите авторизацию OAuth, когда появится запрос. Инструкции по настройке параметров «добавить удалённый сервер MCP» или «пользовательский коннектор» см. в документации клиента.
Предварительные требования
- Node.js версии 24 или выше
Если Node.js ещё не установлен, скачайте его с официального сайта.
Также Node.js можно установить с помощью менеджера пакетов, например Homebrew для macOS или Chocolatey для Windows.
Для установки и управления версиями Node.js рекомендуем использовать NVM (Node Version Manager).
После установки NVM выполните следующие команды, чтобы установить Node.js:
nvm install v24
nvm use v24
Установка
Чтобы установить сервер MCP, выполните одну из команд ниже в зависимости от используемого менеджера пакетов:
# Install globally from npm
npm install -g @hostinger/mcp
# Or with yarn
yarn global add @hostinger/mcp
# Or with pnpm
pnpm add -g @hostinger/mcp
Обновление
Чтобы обновить сервер MCP до последней версии, выполните одну из команд ниже в зависимости от используемого менеджера пакетов:
# Update globally from npm
npm update -g @hostinger/mcp
# Or with yarn
yarn global upgrade @hostinger/mcp
# Or with pnpm
pnpm update -g @hostinger/mcp
Исполняемые файлы
Этот пакет устанавливает следующие команды сервера MCP:
-
hostinger-api-mcp— единый сервер со всеми инструментами (всего 401) -
hostinger-agency-hosting-mcp— 42 инструмента для агентского хостинга -
hostinger-billing-mcp— 9 инструментов для расчётов -
hostinger-dns-mcp— 8 инструментов для DNS -
hostinger-domains-mcp— 41 инструмент для доменов -
hostinger-ecommerce-mcp— 29 инструментов для электронной коммерции -
hostinger-horizons-mcp— 6 инструментов для horizons -
hostinger-hosting-mcp— 74 инструмента для хостинга -
hostinger-mail-mcp— 38 инструментов для почты -
hostinger-reach-mcp— 52 инструмента для reach -
hostinger-vps-mcp— 64 инструмента для VPS -
hostinger-wordpress-mcp— 38 инструментов для wordpress
Выберите исполняемый файл, соответствующий задачам вашего агента. hostinger-api-mcp остаётся вариантом по умолчанию для обратной совместимости.
Конфигурация
При запуске сервера можно настроить следующие переменные окружения:
-
DEBUG: включает отладочное журналирование (true/false), по умолчанию —false -
HOSTINGER_API_TOKEN: ваш токен API, который будет передаваться в заголовкеAuthorization. Если эта переменная задана, OAuth полностью отключается. -
API_TOKEN: устаревший псевдонимHOSTINGER_API_TOKEN. Он будет удалён в будущей версии — используйтеHOSTINGER_API_TOKEN. -
OAUTH_ISSUER: базовый URL сервера OAuth (по умолчанию:https://auth.hostinger.com). Используется только в том случае, еслиHOSTINGER_API_TOKENне задан.
Аутентификация
Сервер поддерживает два способа аутентификации:
Токен API (рекомендуется для CI и скриптов)
Задайте HOSTINGER_API_TOKEN в переменных окружения или в файле .env. Если переменная задана, этот способ всегда имеет приоритет — OAuth не запускается.
OAuth 2.0 с PKCE (интерактивный вход)
Если HOSTINGER_API_TOKEN не задан и сервер работает в режиме stdio, при первом вызове инструмента, требующего аутентификации, автоматически используется OAuth 2.0 с PKCE:
-
Динамический клиент OAuth регистрируется у издателя согласно RFC 7591 — один раз для каждой машины.
-
Откроется окно браузера со страницей авторизации.
-
После входа сервер перехватит перенаправление на локальном временном порту, обменяет код на токены и сохранит их.
-
При последующих вызовах будет использоваться сохранённый токен доступа; срок действия токенов продлевается автоматически. Если токен обновления отозван, процесс авторизации в браузере запустится повторно.
Учётные данные хранятся по следующим путям:
-
macOS / Linux:
~/.config/hostinger-mcp/credentials.json(права доступа 0600) -
Windows:
%APPDATA%\hostinger-mcp\credentials.json
Учётные данные общие для всех исполняемых файлов Hostinger MCP (hostinger-api-mcp, hostinger-vps-mcp и других).
Команды для ручного управления:
# Run the OAuth sign-in flow immediately (don't wait for the first tool call)
hostinger-api-mcp --login
# Revoke stored credentials
hostinger-api-mcp --logout
Примечание о транспорте HTTP: вход через OAuth не поддерживается в режиме --http. Перед запуском с --http задайте HOSTINGER_API_TOKEN.
Использование
Конфигурация JSON для Claude, Cursor и других клиентов
{
"mcpServers": {
"hostinger-api": {
"command": "hostinger-api-mcp",
"env": {
"DEBUG": "false",
"HOSTINGER_API_TOKEN": "YOUR API TOKEN"
}
}
}
}
Варианты транспорта
Сервер MCP поддерживает два режима транспорта:
Транспорт стандартного ввода-вывода
По умолчанию сервер использует транспорт стандартного ввода-вывода (stdio). Он обеспечивает потоковый обмен данными на локальном компьютере:
Транспорт Streamable HTTP
Сервер может использовать потоковый транспорт HTTP, обеспечивающий двусторонний обмен данными через HTTP:
# Default HTTP transport on localhost:8100
hostinger-api-mcp --http
# Specify custom host and port
hostinger-api-mcp --http --host 0.0.0.0 --port 8150
Параметры командной строки
Options:
--http Use HTTP streaming transport (requires HOSTINGER_API_TOKEN env var)
--stdio Use Server-Sent Events transport (default)
--host {host} Hostname or IP address to listen on (default: 127.0.0.1)
--port {port} Port to bind to (default: 8100)
--login Run OAuth sign-in flow and exit
--logout Revoke stored OAuth credentials and exit
--help Show help message
Использование в качестве поставщика инструментов MCP
Этот сервер реализует Model Context Protocol (MCP) и совместим с любым клиентом MCP.
Пример подключения к серверу с использованием потокового транспорта HTTP:
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
// Create HTTP transport
const transport = new StreamableHTTPClientTransport({
url: "http://localhost:8100/",
headers: {
"Authorization": `Bearer ${process.env.HOSTINGER_API_TOKEN}`
}
});
// Connect to the MCP server
const client = new Client({
name: "my-client",
version: "1.0.0"
}, {
capabilities: {}
});
await client.connect(transport);
// List available tools
const { tools } = await client.listTools();
console.log("Available tools:", tools);
// Call a tool
const result = await client.callTool({
name: "billing_getCatalogItemListV1",
arguments: { category: "DOMAIN" }
});
console.log("Tool result:", result);
Доступные инструменты
Этот сервер MCP предоставляет следующие инструменты:
hostinger-agency-hosting-mcp
agency-hosting_deployNodeStaticWebsite
Разворачивает сайт типа node-static в рамках тарифа Agency Plan (h5g) из файла архива. ВНИМАНИЕ: операция перезаписывает текущее содержимое сайта, и её нельзя отменить — перед выполнением обязательно получите подтверждение пользователя. Используйте этот инструмент для сайтов Agency Plan типа node-static: статических сайтов, созданных с помощью Node.js и требующих этапа сборки, или простых статических сайтов. Инструмент определяет сайт по домену, загружает архив в файловый менеджер сайта через TUS и запускает процесс build-assets, который собирает сайт и размещает результат в public_html. Операция выполняется синхронно: сборка и развёртывание завершаются до возврата результата, поэтому после успешного выполнения инструментом сайт сразу становится доступен. Отдельную асинхронную сборку ожидать или проверять не нужно. Данные для загрузки создаются и используются внутри инструмента — не вызывайте отдельный endpoint для получения URL загрузки и не загружайте архив самостоятельно: инструмент выполняет весь процесс целиком. UID сайта определяется автоматически по домену.
-
Метод:
custom -
Путь:
custom
agency-hosting_deployPhpApplication
Развёртывает сайт на PHP (или другом сайте, не требующем сборки) в рамках Agency Plan (h5g) из архивного файла. ВНИМАНИЕ: содержимое сайта будет перезаписано без возможности отмены изменений. Перед продолжением обязательно получите подтверждение пользователя. Используйте этот инструмент для сайтов на Agency Plan, содержимое архива которых нужно просто извлечь и разместить без этапа сборки (например, для приложений на PHP). Инструмент определяет сайт по домену, загружает архив в файловый менеджер сайта по протоколу TUS и запускает процесс импорта архива, который заменяет содержимое сайта файлами из архива. Операция выполняется синхронно: архив извлекается и развёртывается до завершения вызова инструмента. Поэтому после успешного завершения сайт уже доступен — отдельную асинхронную сборку запускать или отслеживать не нужно. Учётные данные для загрузки создаются и используются автоматически. Не вызывайте отдельный endpoint для получения URL загрузки и не загружайте архив самостоятельно: инструмент выполняет весь процесс целиком. Для статических сайтов на Node.js, которым требуется этап сборки, используйте agencyHosting_deployNodeStaticWebsite. UID сайта определяется автоматически по домену.
-
Method:
custom -
Path:
custom
agency-hosting_listAvailableDatacentersV1
Возвращает список дата-центров, доступных для размещения нового сайта в рамках заказа
на Agency Plan.
Для каждого дата-центра указан pinger_url. Отправьте на него ping-запрос с клиентской стороны, чтобы измерить задержку туда и обратно. Сравнив результаты для разных дата-центров, можно выбрать ближайший — с наименьшим значением ping — и указать его code в качестве datacenter_code при создании параметров сайта.
-
Method:
GET -
Path:
/api/agency-hosting/v1/orders/{order_id}/datacenters
agency-hosting_changeWebsiteDomainV1
Изменяет основной домен сайта в рамках Agency Plan.
Укажите текущий домен в пути запроса, а новый домен — в теле запроса.
Чтобы вернуть временный домен, задайте для domain значение null.
-
Method:
PUT -
Path:
/api/agency-hosting/v1/websites/{website_uid}/domains/{from_domain}
agency-hosting_linkDomainToWebsiteV1
Привязывает домен к указанному сайту в рамках Agency Plan, чтобы сайт мог обслуживать запросы для этого домена.
-
Method:
POST -
Path:
/api/agency-hosting/v1/websites/{website_uid}/domains
agency-hosting_listDomainsV1
Возвращает постраничный список доменов, связанных с сайтами в рамках Agency Plan, доступными авторизованному клиенту.
Чтобы отфильтровать результаты по конкретным сайтам, используйте фильтр website_uuids.
-
Method:
GET -
Path:
/api/agency-hosting/v1/domains
agency-hosting_unlinkDomainFromWebsiteV1
Отвязывает домен от указанного сайта в рамках Agency Plan.
Сайт перестаёт обслуживать запросы для этого домена сразу после отвязки.
Файлы сайта и база данных сохраняются, а другие привязанные домены продолжают работать.
Если это единственный домен сайта, после отвязки сайт останется без доступного домена.
-
Method:
DELETE -
Path:
/api/agency-hosting/v1/websites/{website_uid}/domains/{domain}
agency-hosting_generateUploadURLV1
Создаёт URL для загрузки файлов в файловое хранилище сайта в рамках Agency Plan и возвращает учётные данные для аутентификации.
В ответе возвращаются url, auth_key и rest_auth_key. Используйте их для загрузки файла в файловое хранилище сайта по протоколу возобновляемой загрузки TUS (TUS 1.0.0). Добавляйте заголовки X-Auth: {auth_key} и X-Auth-Rest: {rest_auth_key} ко всем перечисленным ниже запросам.
- Создайте загрузку: отправьте
POSTна{url}/{relative_file_path}?override=trueс заголовками
upload-length: {file size in bytes} и upload-offset: 0. Ожидаемый ответ — 201 Created.
- Загрузите файл: отправляйте его байты по тому же адресу с помощью любого клиента TUS 1.0.0 или запросов
PATCH, отслеживая ход загрузки через заголовокupload-offset, пока передача не завершится.
relative_file_path — путь назначения внутри файлового хранилища сайта, например
app.zip.
Вместо клиента TUS можно использовать обычный curl:
201 Created
curl -i -X PATCH "{url}/${FILE}?override=true"
-H "X-Auth: {auth_key}"
-H "X-Auth-Rest: {rest_auth_key}"
-H "Tus-Resumable: 1.0.0"
-H "Content-Type: application/offset+octet-stream"
-H "Upload-Offset: 0"
--data-binary "@${FILE}"
-> 204 No Content, Upload-Offset response header equals SIZE when done">
FILE=app.zip
SIZE=$(stat -f%z "$FILE") # stat -c%s on Linux
curl -i -X POST "{url}/${FILE}?override=true" \
-H "X-Auth: {auth_key}" \
-H "X-Auth-Rest: {rest_auth_key}" \
-H "Tus-Resumable: 1.0.0" \
-H "Upload-Length: ${SIZE}" \
-H "Upload-Offset: 0"
# -> 201 Created
curl -i -X PATCH "{url}/${FILE}?override=true" \
-H "X-Auth: {auth_key}" \
-H "X-Auth-Rest: {rest_auth_key}" \
-H "Tus-Resumable: 1.0.0" \
-H "Content-Type: application/offset+octet-stream" \
-H "Upload-Offset: 0" \
--data-binary "@${FILE}"
# -> 204 No Content, Upload-Offset response header equals SIZE when done
-
Method:
POST -
Path:
/api/agency-hosting/v1/websites/{website_uid}/files/upload-urls
agency-hosting_importWebsiteFromArchiveV1
Импортирует сайт в рамках Agency Plan из уже загруженного архива.
Сначала загрузите архив в корневой каталог сайта через файловый менеджер, затем укажите его имя в этом запросе. Содержимое сайта будет заменено содержимым архива. Поддерживаются архивы следующих типов: .zip, .tar, .tar.gz, .tgz.
-
Method:
POST -
Path:
/api/agency-hosting/v1/websites/{website_uid}/files/import-archive
agency-hosting_listAgencyPlanOrderDiskUsageMetricsV1
Возвращает суммарное использование дискового пространства и inode для заказа Agency Plan за выбранный период, а также квоты тарифного плана. Показатели учитывают весь аккаунт заказа. Данные могут отставать от актуальных максимум на один час. Использование CPU, памяти и процессов возвращается через endpoint resource-usage-metrics.
-
Method:
GET -
Path:
/api/agency-hosting/v1/orders/{order_id}/disk-usage-metrics
agency-hosting_listOrdersV1
Возвращает постраничный список заказов Agency Plan, доступных авторизованному клиенту.
-
Method:
GET -
Path:
/api/agency-hosting/v1/orders
agency-hosting_listOrderResourceUsageMetricsV1
Возвращает суммарное использование CPU, памяти и процессов для заказа Agency Plan за выбранный период, а также квоты тарифного плана и разбивку по сайтам. Каждый сайт обозначен UID. При подсчёте общих показателей заказа и формировании разбивки по сайтам приостановленные и удалённые сайты не учитываются.
Данные могут отставать от актуальных максимум на один час. Использование дискового пространства и inode возвращается через endpoint disk-usage-metrics.
-
Method:
GET -
Path:
/api/agency-hosting/v1/orders/{order_id}/resource-usage-metrics
agency-hosting_listPHPExtensionsForAWebsiteV1
Возвращает список всех PHP-расширений, доступных сайту в рамках Agency Plan, и указывает, включено ли каждое из них.
-
Method:
GET -
Path:
/api/agency-hosting/v1/websites/{website_uid}/php-settings/extensions
agency-hosting_replaceWebsitePHPExtensionsV1
Заменяет набор PHP-расширений, включённых на сайте в рамках Agency Plan, на указанный в запросе. Все расширения, которыми можно управлять, но которые не указаны в запросе, будут отключены. Поэтому сначала вызовите endpoint со списком расширений и передайте полный набор, который нужно включить. Расширения, встроенные в PHP и обозначенные состоянием "built-in", всегда активны; этот запрос на них не влияет.
-
Method:
PUT -
Path:
/api/agency-hosting/v1/websites/{website_uid}/php-settings/extensions
agency-hosting_listPHPOptionsForAWebsiteV1
Возвращает список директив php.ini, которые можно настроить для сайта в рамках Agency Plan. Для каждой директивы указываются значение по умолчанию, действующее значение и допустимые значения.
-
Method:
GET -
Path:
/api/agency-hosting/v1/websites/{website_uid}/php-settings/options
agency-hosting_replaceWebsitePHPOptionsV1
Заменяет пользовательские значения php.ini на сайте в рамках Agency Plan значениями, указанными в запросе. Параметры, не включённые в запрос, будут сброшены до значений по умолчанию. Поэтому сначала вызовите endpoint со списком параметров и передайте полный набор нужных значений. Если отправить пустой массив, все параметры будут сброшены до значений по умолчанию.
-
Method:
PUT -
Path:
/api/agency-hosting/v1/websites/{website_uid}/php-settings/options
agency-hosting_listAvailablePHPVersionsForAnOrderV1
Возвращает список версий PHP, доступных сайтам, создаваемым в рамках заказа Agency Plan. Список определяется сервером, на котором размещён заказ. Используйте этот endpoint до создания сайта. Для уже существующего сайта вызовите endpoint со списком версий для конкретного сайта.
-
Method:
GET -
Path:
/api/agency-hosting/v1/orders/{order_id}/websites/php-settings/versions
agency-hosting_listAvailablePHPVersionsForAWebsiteV1
Возвращает список версий PHP, на которые можно переключить сайт в рамках Agency Plan. Текущая версия сайта указана в поле settings.php.version ответа endpoint с данными сайта.
-
Method:
GET -
Path:
/api/agency-hosting/v1/websites/{website_uid}/php-settings/versions
agency-hosting_updateWebsitePHPVersionV1
Переключает сайт на тарифе Agency Plan на другую версию PHP. Сначала вызовите эндпоинт со списком доступных версий, чтобы узнать, какие из них можно выбрать. Во время переключения сайт перезапускается, поэтому запросы могут завершиться ошибкой, а код, несовместимый с целевой версией, перестанет работать.
-
Method:
PATCH -
Path:
/api/agency-hosting/v1/websites/{website_uid}/php-settings/version
agency-hosting_createANewWebsiteV1
Создаёт новый сайт на одном из ваших заказов хостинга Agency Plan.
Для сайта можно выбрать дата-центр, стек (flavor) и версию PHP. При необходимости укажите собственный
domain. Если параметр не задан, установлен в null или домен недоступен, вместо него будет создан бесплатный поддомен
*.hostingersite.com. Также можно установить WordPress, передав параметры wordpress (учётные данные администратора, название сайта и язык).
Типовые конфигурации:
- Сайт на PHP без CMS: задайте
flavorравнымphp-fpmи укажитеsettings.php.version. Не передавайте
wordpress и type.
- Сайт на WordPress: задайте
flavorравным нужной версии WordPress (например,wp-7.0) и передайте
блок wordpress (учётные данные администратора, название сайта и язык).
- Статическое приложение или фронтенд-приложение на Node.js: задайте
flavorравнымphp-fpm, аtype—
node-static.
Создание сайта выполняется в фоновом режиме, поэтому ответ возвращается сразу и содержит UUID задачи настройки. Новый сайт станет доступен после завершения настройки.
-
Method:
POST -
Path:
/api/agency-hosting/v1/orders/{order_id}/websites/setups
agency-hosting_getWebsiteSetupStatusV1
Возвращает текущий статус настройки сайта на тарифе Agency Plan, запущенной через эндпоинт setups.
Периодически вызывайте этот эндпоинт, передавая setup_uuid, полученный в ответе на запрос создания сайта, пока значение status не станет completed. После этого параметр website_uid будет содержать идентификатор нового сайта.
-
Method:
GET -
Path:
/api/agency-hosting/v1/orders/{order_id}/websites/setups/{setup_uuid}
agency-hosting_reinstallWebsiteSSLV1
Заменяет сертификат Let's Encrypt для домена: если в системе сохранён действующий сертификат платформы, он отзывается и удаляется, после чего в фоновом режиме запускается настройка нового сертификата. Ответ возвращается сразу. Пока идёт настройка, эндпоинт Get website SSL status сообщает статус installing, а по завершении — active или failed.
Возвращает 422 для бесплатных поддоменов, если для домена уже зарегистрирован процесс настройки сертификата (незавершённая неудачная настройка также учитывается, пока её не очистят) или если для домена исчерпан лимит — три настройки за семь дней. Возвращает 429, если запрос для того же домена уже отправлялся менее минуты назад; 403 — если сайт приостановлен или заблокирован; 404 — если сайт или домен не существует.
-
Method:
POST -
Path:
/api/agency-hosting/v1/websites/{website_uid}/domains/{domain}/ssl/reinstall
agency-hosting_installWebsiteSSLV1
Запускает настройку сертификата Let's Encrypt для домена и сразу возвращает ответ. Настройка выполняется в фоновом режиме. Пока она идёт, эндпоинт Get website SSL status сообщает статус installing, а по завершении — active или failed. Тот же ход настройки отображается в записи ssl_setup эндпоинта List website processes.
Возвращает 422, если для домена уже есть действующий сертификат платформы, если для домена уже зарегистрирован процесс настройки сертификата (незавершённая неудачная настройка также учитывается, пока её не очистят) или если для домена исчерпан лимит — три настройки за семь дней. Возвращает 429, если запрос для того же домена уже отправлялся менее минуты назад; 403 — если сайт приостановлен или заблокирован; 404 — если сайт или домен не существует.
-
Method:
POST -
Path:
/api/agency-hosting/v1/websites/{website_uid}/domains/{domain}/ssl/setup
agency-hosting_getWebsiteSSLStatusV1
Возвращает состояние SSL для домена сайта на тарифе Agency Plan: статус сертификата status, сведения о том, был ли сертификат загружен клиентом, и срок его действия.
Статус installing означает, что настройка сертификата выполняется или повторяется. Ход настройки также отображается в записи ssl_setup эндпоинта List website processes. Статус active означает, что установлен действующий сертификат: загруженный клиентом, выданный платформой или бессрочный сертификат, приобретённый для домена. Статус failed означает, что последняя попытка настройки завершилась неудачей и действующего сертификата нет. Статус expired означает, что срок действия сертификата истёк. Статус not_installed означает, что для домена нет ни сертификата, ни процесса настройки. Возвращает 404, если сайт или домен не существует.
-
Method:
GET -
Path:
/api/agency-hosting/v1/websites/{website_uid}/domains/{domain}/ssl/status
agency-hosting_uninstallWebsiteSSLV1
Удаляет выданный платформой сертификат Let's Encrypt для домена: перед отправкой ответа сертификат отзывается и удаляется. До завершения настройки нового сертификата платформа больше не будет обслуживать домен с использованием своего сертификата. Операция также завершается успешно, если у домена нет сертификата платформы. Загруженные клиентом сертификаты не затрагиваются.
Возвращает 422, если для домена зарегистрирован процесс настройки сертификата (незавершённая неудачная настройка также учитывается, пока её не очистят); 429 — если запрос для того же домена уже отправлялся менее минуты назад; 403 — если сайт приостановлен или заблокирован; 404 — если сайт или домен не существует.
-
Method:
DELETE -
Path:
/api/agency-hosting/v1/websites/{website_uid}/domains/{domain}/ssl
agency-hosting_buildWebsiteNodeJSAssetsV1
Собирает и развёртывает приложение Node.js для сайта на тарифе Agency Plan из загруженного ранее архива.
Сначала загрузите архив через файловый менеджер, затем укажите в запросе его относительный путь от корневого каталога сайта.
Содержимое сайта будет заменено результатами сборки, которые затем будут размещены в public_html.
-
Method:
POST -
Path:
/api/agency-hosting/v1/websites/{website_uid}/build-assets
agency-hosting_clearWebsiteCacheV1
Очищает кэш для всех доменов, связанных с сайтом на тарифе Agency Plan, включая домен предварительного просмотра.
Операция очищает кэш всех типов для этого сайта.
-
Method:
DELETE -
Path:
/api/agency-hosting/v1/websites/{website_uid}/cache
agency-hosting_listWebsiteCronJobsV1
Возвращает постраничный список cron-задач, настроенных для сайта на тарифе Agency Plan.
Каждая запись содержит выражение расписания и команду, которая выполняется по этому расписанию.
-
Method:
GET -
Path:
/api/agency-hosting/v1/websites/{website_uid}/cron-jobs
agency-hosting_createWebsiteCronJobV1
Создаёт cron-задачу для сайта на тарифе Agency Plan на основе выражения расписания и команды.
Возвращает созданную cron-задачу, в том числе её uuid, необходимый для удаления.
-
Method:
POST -
Path:
/api/agency-hosting/v1/websites/{website_uid}/cron-jobs
agency-hosting_deleteWebsiteCronJobV1
Безвозвратно удаляет с сайта на тарифе Agency Plan cron-задачу с указанным uuid.
Операция идемпотентна: удаление несуществующей cron-задачи завершается успешно и не приводит к ошибке.
-
Method:
DELETE -
Path:
/api/agency-hosting/v1/websites/{website_uid}/cron-jobs/{uuid}
agency-hosting_listWebsiteDatabasesV1
Возвращает постраничный список баз данных MySQL, созданных для сайта на тарифе Agency Plan.
В каждой записи перечислены пользователи базы данных, кроме системных.
-
Method:
GET -
Path:
/api/agency-hosting/v1/websites/{website_uid}/databases
agency-hosting_createWebsiteDatabaseV1
Создаёт базу данных MySQL с отдельным пользователем для сайта на тарифе Agency Plan.
Имя базы данных, имя пользователя и пароль должны быть указаны вызывающей стороной.
-
Method:
POST -
Path:
/api/agency-hosting/v1/websites/{website_uid}/databases
agency-hosting_deleteWebsiteDatabaseV1
Безвозвратно удаляет с сайта на тарифе Agency Plan базу данных MySQL вместе со всеми её данными и пользователями.
Операция идемпотентна: удаление несуществующей базы данных завершается успешно и не приводит к ошибке.
-
Method:
DELETE -
Path:
/api/agency-hosting/v1/websites/{website_uid}/databases/{database_name}
agency-hosting_createWebsiteDatabaseUserV1
Создаёт пользователя для существующей базы данных на сайте на тарифе Agency Plan.
Для каждой базы данных разрешён только один пользователь, отличный от системных. Если такой пользователь уже существует, создать нового не удастся.
-
Method:
POST -
Path:
/api/agency-hosting/v1/websites/{website_uid}/databases/{database_name}/users
agency-hosting_deleteWebsiteDatabaseUserV1
Безвозвратно удаляет пользователя базы данных на сайте Agency Plan и отзывает все его права доступа.
Операция идемпотентна: удаление несуществующего пользователя завершается успешно и не приводит к ошибке.
-
Method:
DELETE -
Path:
/api/agency-hosting/v1/websites/{website_uid}/databases/{database_name}/users/{database_user_name}
agency-hosting_getWebsiteDetailsV1
Возвращает подробную информацию о выбранном сайте на тарифе Agency Plan, включая его конфигурацию,
статус, метаданные, сведения о тарифном плане хостинга и квоты ресурсов.
-
Method:
GET -
Path:
/api/agency-hosting/v1/websites/{website_uid}
agency-hosting_deleteWebsiteV1
Безвозвратно удаляет сайт на тарифном плане Agency Plan. Удаление выполняется асинхронно: сайт сразу переводится в состояние удаления, а связанные с ним серверные ресурсы удаляются в фоновом режиме.
-
Метод:
DELETE -
Путь:
/api/agency-hosting/v1/websites/{website_uid}
agency-hosting_listAgencyPlanWebsitesV1
Возвращает постраничный список сайтов на тарифном плане Agency Plan (H5G, Builder и Horizons), доступных аутентифицированному клиенту.
В ответ включаются сайты из ваших аккаунтов хостинга, а также сайты из аккаунтов других клиентов, которые предоставили вам доступ.
Структура ответа зависит от платформы. Информацию о ней содержит поле platform каждого элемента.
Чтобы получить только сайты определённого типа, укажите параметр website_types. Например, для поиска только сайтов WordPress используйте website_types=wordpress, а для сайтов Node.js — website_types=nodejs. Для более точного поиска можно сочетать этот параметр с order_ids, states или domain.
-
Метод:
GET -
Путь:
/api/agency-hosting/v1/websites
agency-hosting_listWebsiteProcessesV1
Возвращает список активных и недавно завершённых асинхронных процессов для сайта на тарифном плане Agency Plan.
У каждого процесса есть уникальный идентификатор для отслеживания, тип и статус: выполняется, завершён или завершился с ошибкой.
После запуска асинхронной операции, например настройки SSL, создания резервной копии или клонирования, опрашивайте этот endpoint, чтобы отслеживать её ход.
-
Метод:
GET -
Путь:
/api/agency-hosting/v1/websites/{website_uid}/processes
agency-hosting_changeWordPressVersionV1
Изменяет установленную версию ядра WordPress на сайте с тарифным планом Agency Plan на одну из доступных для установки версий.
-
Метод:
PATCH -
Путь:
/api/agency-hosting/v1/websites/{website_uid}/wordpress/settings/version
agency-hosting_getWordPressSettingsV1
Возвращает текущие настройки WordPress для сайта на тарифном плане Agency Plan: установленную версию ядра, состояние плагина LiteSpeed Cache, кэша объектов и режима обслуживания.
-
Метод:
GET -
Путь:
/api/agency-hosting/v1/websites/{website_uid}/wordpress/settings
agency-hosting_listAvailableWordPressVersionsV1
Возвращает список версий ядра WordPress, доступных для установки на сайте с тарифным планом Agency Plan.
-
Метод:
GET -
Путь:
/api/agency-hosting/v1/websites/{website_uid}/wordpress/settings/versions
hostinger-billing-mcp
billing_getCatalogItemListV1
Возвращает список товаров и услуг из каталога, доступных для заказа.
Цены в каталоге указаны в центах, без использования чисел с плавающей точкой. Например, значение 17.99 отображается как целое число 1799.
Используйте этот endpoint, чтобы посмотреть доступные услуги и цены перед оформлением заказа.
-
Метод:
GET -
Путь:
/api/billing/v1/catalog
billing_createPurchaseOrderV1
Создаёт заказ на покупку любого продукта Hostinger.
Этот универсальный endpoint позволяет заказать один или несколько товаров из каталога и работает со всеми продуктами Hostinger, используя существующую биллинговую инфраструктуру. Чтобы узнать доступные для покупки значения item_id, обратитесь к endpoint каталога.
Если способ оплаты не указан, автоматически используется выбранный по умолчанию.
Если ответ имеет статус 202 Accepted, платёж ещё обрабатывается. Заказ будет завершён асинхронно после подтверждения оплаты.
Этот endpoint только оформляет заказ. Настройка продукта, например VPS или регистрация домена, здесь не выполняется. После завершения заказа используйте соответствующие endpoint продукта или hPanel, чтобы завершить настройку.
Используйте этот endpoint для покупки любого продукта, доступного в каталоге.
-
Метод:
POST -
Путь:
/api/billing/v1/orders
billing_setDefaultPaymentMethodV1
Устанавливает способ оплаты по умолчанию для аккаунта.
Используйте этот endpoint, чтобы выбрать основной способ оплаты для будущих заказов.
-
Метод:
POST -
Путь:
/api/billing/v1/payment-methods/{paymentMethodId}
billing_deletePaymentMethodV1
Удаляет способ оплаты из аккаунта.
Используйте этот endpoint, чтобы удалить неиспользуемые способы оплаты из аккаунтов пользователей.
-
Метод:
DELETE -
Путь:
/api/billing/v1/payment-methods/{paymentMethodId}
billing_getPaymentMethodListV1
Возвращает список доступных способов оплаты, которые можно использовать для оформления заказов.
Чтобы добавить новый способ оплаты, воспользуйтесь hPanel.
Используйте этот endpoint, чтобы проверить доступные способы оплаты перед оформлением заказа.
-
Метод:
GET -
Путь:
/api/billing/v1/payment-methods
billing_getSubscriptionListV1
Возвращает список всех подписок, связанных с вашим аккаунтом.
Используйте этот endpoint, чтобы отслеживать активные услуги и состояние платежей.
-
Метод:
GET -
Путь:
/api/billing/v1/subscriptions
billing_disableAutoRenewalV1
Отключает автоматическое продление подписки.
Используйте этот endpoint, чтобы отключить автоматическое продление подписки.
-
Метод:
DELETE -
Путь:
/api/billing/v1/subscriptions/{subscriptionId}/auto-renewal/disable
billing_enableAutoRenewalV1
Включает автоматическое продление подписки.
Используйте этот endpoint, чтобы включить автоматическое продление подписки.
-
Метод:
PATCH -
Путь:
/api/billing/v1/subscriptions/{subscriptionId}/auto-renewal/enable
billing_renewSubscriptionV1
Создаёт заказ на продление существующей подписки Hostinger.
Этот endpoint оформляет заказ на продление одной подписки с использованием существующей биллинговой инфраструктуры. Чтобы узнать доступные для продления значения subscriptionId, обратитесь к endpoint подписок.
Если способ оплаты не указан, автоматически используется выбранный по умолчанию.
Если ответ имеет статус 202 Accepted, платёж ещё обрабатывается. Продление будет завершено асинхронно после подтверждения оплаты.
Используйте этот endpoint, чтобы продлить любую подписку в аккаунте.
-
Метод:
POST -
Путь:
/api/billing/v1/subscriptions/{subscriptionId}/renew
hostinger-dns-mcp
DNS_getDNSSnapshotV1
Возвращает выбранный снимок DNS с содержимым записей DNS-зоны.
Используйте этот endpoint, чтобы просмотреть предыдущие конфигурации DNS домена.
-
Метод:
GET -
Путь:
/api/dns/v1/snapshots/{domain}/{snapshotId}
DNS_getDNSSnapshotListV1
Возвращает список снимков DNS для домена.
Используйте этот endpoint, чтобы просмотреть доступные точки восстановления резервной копии DNS.
-
Метод:
GET -
Путь:
/api/dns/v1/snapshots/{domain}
DNS_restoreDNSSnapshotV1
Восстанавливает DNS-зону из выбранного снимка.
Используйте этот endpoint, чтобы вернуть предыдущую конфигурацию DNS домена.
-
Метод:
POST -
Путь:
/api/dns/v1/snapshots/{domain}/{snapshotId}/restore
DNS_getDNSRecordsV1
Возвращает записи DNS-зоны указанного домена.
Используйте этот endpoint, чтобы просмотреть текущую конфигурацию DNS домена.
-
Метод:
GET -
Путь:
/api/dns/v1/zones/{domain}
DNS_updateDNSRecordsV1
Обновляет записи DNS для выбранного домена.
Если указать overwrite = true, существующие записи будут заменены переданными.
В противном случае существующие записи будут обновлены, а новые — добавлены.
Используйте этот endpoint, чтобы изменить конфигурацию DNS домена.
-
Метод:
PUT -
Путь:
/api/dns/v1/zones/{domain}
DNS_deleteDNSRecordsV1
Удаляет записи DNS для выбранного домена.
Чтобы указать, какие записи нужно удалить, добавьте в фильтр их name и type.
В одном запросе можно передать несколько фильтров.
Если существуют несколько записей с одинаковыми именем и типом и требуется удалить только часть из них, обратитесь к endpoint Update zone records.
Используйте этот endpoint, чтобы удалить определённые записи DNS домена.
-
Метод:
DELETE -
Путь:
/api/dns/v1/zones/{domain}
DNS_resetDNSRecordsV1
Сбрасывает DNS-зону до записей по умолчанию.
Используйте этот endpoint, чтобы восстановить исходную конфигурацию DNS домена.
-
Метод:
POST -
Путь:
/api/dns/v1/zones/{domain}/reset
DNS_validateDNSRecordsV1
Проверяет записи DNS выбранного домена перед обновлением.
Если проверка пройдена успешно, в ответе будет код 200 Success.
При ошибке проверки запрос завершится с кодом 422 Validation error.
Используйте этот endpoint, чтобы проверить корректность записей DNS перед применением изменений.
-
Метод:
POST -
Путь:
/api/dns/v1/zones/{domain}/validate
hostinger-domains-mcp
v2_getDomainVerificationsDIRECT
Возвращает список ожидающих выполнения и завершённых проверок доменов.
-
Метод:
GET -
Путь:
/api/v2/direct/verifications/active
domains_suggestDomainNamesFromADescriptionV1
Предлагает доступные доменные имена на основе текстового описания проекта.
Предложения генерируются моделью ИИ, поэтому при каждом вызове они могут отличаться.
Ограничение частоты запросов к endpoint — 90 запросов в минуту.
Используйте этот endpoint, если хотите подобрать доменное имя, зная только тематику сайта.
-
Method:
POST -
Path:
/api/domains/v1/availability/alternatives-from-description
domains_suggestDomainNamesFromADomainV1
Предлагает доступные доменные имена на основе уже выбранного доменного имени.
Предложения генерируются моделью ИИ, поэтому при каждом вызове они могут отличаться.
Ограничение частоты запросов к endpoint — 90 запросов в минуту.
Используйте этот endpoint, если нужный домен уже занят и вам нужны похожие варианты.
-
Method:
POST -
Path:
/api/domains/v1/availability/alternatives-from-domain
domains_checkDomainAvailabilityV1
Проверяет доступность доменных имён в нескольких TLD.
За один запрос можно проверить несколько TLD.
Чтобы получить альтернативные домены вместе с результатом проверки, укажите только один TLD и задайте with_alternatives равным true.
Указывайте TLD без точки в начале (например, com, net, org).
Ограничение частоты запросов к endpoint — 90 запросов в минуту.
Используйте этот endpoint, чтобы проверить доступность домена перед покупкой.
-
Method:
POST -
Path:
/api/domains/v1/availability
domains_getDomainForwardingV1
Получает данные о перенаправлении домена.
Используйте этот endpoint, чтобы просмотреть текущие настройки перенаправления домена.
-
Method:
GET -
Path:
/api/domains/v1/forwarding/{domain}
domains_updateDomainForwardingV1
Обновляет настройки перенаправления домена.
Используйте этот endpoint, чтобы изменить существующие настройки перенаправления домена.
-
Method:
PUT -
Path:
/api/domains/v1/forwarding/{domain}
domains_deleteDomainForwardingV1
Удаляет данные о перенаправлении домена.
Используйте этот endpoint, чтобы удалить настройки перенаправления домена.
-
Method:
DELETE -
Path:
/api/domains/v1/forwarding/{domain}
domains_createDomainForwardingV1
Создаёт настройки перенаправления домена.
Используйте этот endpoint, чтобы настроить перенаправление домена на другие URL.
-
Method:
POST -
Path:
/api/domains/v1/forwarding
domains_getPendingIRTPVerificationV1
Получает сведения об ожидающем подтверждения запросе IRTP для домена.
Чтобы изменения WHOIS вступили в силу, их должны подтвердить и прежний, и новый владельцы домена.
Используйте этот endpoint, чтобы проверить статус изменений WHOIS, ожидающих подтверждения владельца.
-
Method:
GET -
Path:
/api/domains/v1/irtp/{domain}
domains_cancelPendingIRTPVerificationV1
Отменяет ожидающее подтверждения действие IRTP.
Используйте этот endpoint, чтобы отменить изменение WHOIS, которое ожидает подтверждения владельца,
например, если письмо с подтверждением невозможно получить. В этом случае не нужно ждать окончания 5-дневного срока действия запроса.
-
Method:
DELETE -
Path:
/api/domains/v1/irtp/{domain}
domains_getIncomingDomainMoveV1
Получает сведения о входящем переносе указанного домена.
Возвращает 404, если ни один аккаунт не переносит этот домен в ваш аккаунт.
Используйте этот endpoint, чтобы проверить, ожидает ли адресованный вам домен принятия.
-
Method:
GET -
Path:
/api/domains/v1/move/incoming/{domain}
domains_acceptIncomingDomainMoveV1
Принимает входящий перенос указанного домена.
Указанные профили WHOIS станут контактными данными домена, поэтому они должны принадлежать вашему аккаунту
и соответствовать требованиям TLD. Применяются только типы контактов, которые используются доменом,
однако необходимо указать идентификаторы всех четырёх профилей.
Перенос должен всё ещё ожидать вашего решения: уже принятый перенос нельзя принять повторно.
Принятие не завершает перенос. На адрес электронной почты нового владельца отправляется письмо с подтверждением,
и домен переходит к нему только после подтверждения из этого письма.
До этого момента перенос остаётся в статусе activating. Отслеживать его можно с помощью endpoint входящих переносов.
Используйте этот endpoint, чтобы принять предложенный вам домен.
-
Method:
PUT -
Path:
/api/domains/v1/move/incoming/{domain}
domains_rejectIncomingDomainMoveV1
Отклоняет входящий перенос указанного домена.
Домен останется в аккаунте, из которого был инициирован перенос.
Перенос, который вы уже приняли, отклонить нельзя.
Используйте этот endpoint, чтобы отказаться от домена, который вы не хотите принимать.
-
Method:
DELETE -
Path:
/api/domains/v1/move/incoming/{domain}
domains_getIncomingDomainMoveListV1
Получает список всех доменов, которые другие аккаунты Hostinger переносят в ваш аккаунт.
Возвращаются переносы с любым статусом, в том числе уже завершённые.
Используйте этот endpoint, чтобы найти домены, ожидающие вашего принятия.
-
Method:
GET -
Path:
/api/domains/v1/move/incoming
domains_getOutgoingDomainMoveV1
Получает сведения об исходящем переносе указанного домена.
Возвращает 404, если перенос домена не выполняется.
Используйте этот endpoint, чтобы отслеживать статус переноса отдельного домена, инициированного вами.
-
Method:
GET -
Path:
/api/domains/v1/move/outgoing/{domain}
domains_startOutgoingDomainMoveV1
Инициирует перенос указанного домена в другой аккаунт Hostinger.
Аккаунт получателя должен уже существовать и принять перенос, прежде чем домен перейдёт к нему.
Домен должен быть активен. Подписка, к которой он относится, определяется автоматически.
Если у домена нет собственной подписки на домен, запрос отклоняется с кодом состояния 404.
Для доменов с премиальной защитой требуется дополнительный этап проверки.
Такие запросы отклоняются с кодом состояния 428.
Используйте этот endpoint, чтобы передать домен другому пользователю Hostinger.
-
Method:
POST -
Path:
/api/domains/v1/move/outgoing/{domain}
domains_cancelOutgoingDomainMoveV1
Отменяет исходящий перенос указанного домена.
Отменить перенос можно только до того, как аккаунт получателя его примет.
Домен останется в вашем аккаунте.
Используйте этот endpoint, чтобы отозвать перенос, который вы больше не хотите завершать.
-
Method:
DELETE -
Path:
/api/domains/v1/move/outgoing/{domain}
domains_getOutgoingDomainMoveListV1
Получает список всех доменов, которые вы переносите в другие аккаунты Hostinger.
Возвращаются только переносы, которые ещё не завершены.
Используйте этот endpoint, чтобы отслеживать инициированные вами переносы и аккаунты, которым они адресованы.
-
Method:
GET -
Path:
/api/domains/v1/move/outgoing
domains_getDomainAuthorizationCodeV1
Получает код авторизации (EPP) для указанного домена. Он нужен, чтобы перенести домен от Hostinger к другому регистратору.
Запрос нового кода аннулирует все коды, полученные ранее.
Используйте этот endpoint, чтобы получить код, необходимый для переноса домена к другому регистратору.
-
Method:
GET -
Path:
/api/domains/v1/portfolio/{domain}/auth-code
domains_claimFreeDomainV1
Регистрирует бесплатный домен, доступный в вашем аккаунте.
В отличие от покупки домена, регистрация расходует уже доступный вам бесплатный домен,
поэтому указывать способ оплаты не нужно.
Успешный ответ означает, что домен зарегистрирован. Если регистрация не удалась, войдите в
hPanel и проверьте статус регистрации домена.
Если сведения WHOIS не указаны, будут использованы контактные данные по умолчанию для этого TLD.
Перед отправкой запроса убедитесь, что в вашем аккаунте есть сведения WHOIS для нужного TLD.
Для некоторых TLD требуется указать additional_details; эти данные проверяются перед регистрацией.
Если выполнить запрос невозможно, в теле ответа возвращается код ошибки,
например, 2037, если бесплатные домены недоступны.
Используйте этот endpoint, чтобы зарегистрировать домен за счёт бесплатного домена из вашего аккаунта.
-
Method:
POST -
Path:
/api/domains/v1/portfolio/claim
domains_enableDomainLockV1
Включает блокировку домена.
При включённой блокировке домен нельзя перенести к другому регистратору, пока блокировка не будет снята.
Используйте этот endpoint, чтобы защитить домены от несанкционированного переноса.
-
Method:
PUT -
Path:
/api/domains/v1/portfolio/{domain}/domain-lock
domains_disableDomainLockV1
Отключает блокировку домена.
Перед переносом домена к другому регистратору блокировку необходимо отключить.
Используйте этот endpoint, чтобы подготовить домен к переносу к другому регистратору.
-
Method:
DELETE -
Path:
/api/domains/v1/portfolio/{domain}/domain-lock
domains_getDomainDetailsV1
Получает подробную информацию об указанном домене.
Используйте этот endpoint, чтобы просмотреть полные сведения о настройках и статусе домена.
-
Method:
GET -
Path:
/api/domains/v1/portfolio/{domain}
domains_getDomainListV1
Получает список всех доменов, связанных с вашим аккаунтом.
Используйте этот endpoint, чтобы просмотреть список доменов пользователя.
-
Method:
GET -
Path:
/api/domains/v1/portfolio
domains_purchaseNewDomainV1
Приобретает и регистрирует новое доменное имя.
Если регистрация не удалась, войдите в hPanel и проверьте статус регистрации домена.
Если способ оплаты не указан, автоматически будет использован способ оплаты по умолчанию.
Если получен ответ 202 Accepted, обработка платежа ещё не завершена, а домен не зарегистрирован. После завершения заказа зарегистрируйте домен через hPanel.
Если информация WHOIS не указана, будут использованы контактные данные по умолчанию для соответствующей TLD.
Перед отправкой запроса убедитесь, что в вашем аккаунте есть информация WHOIS для нужной TLD.
Для некоторых TLD необходимо указать additional_details. Эти данные проверяются до завершения покупки.
Используйте эту конечную точку, чтобы регистрировать новые домены для пользователей.
-
Method:
POST -
Path:
/api/domains/v1/portfolio
domains_enablePrivacyProtectionV1
Включает защиту конфиденциальности домена.
При включённой защите конфиденциальности личные данные владельца домена скрыты в общедоступной базе данных WHOIS.
Используйте эту конечную точку, чтобы скрыть личные данные владельца домена от общего доступа.
-
Method:
PUT -
Path:
/api/domains/v1/portfolio/{domain}/privacy-protection
domains_disablePrivacyProtectionV1
Отключает защиту конфиденциальности домена.
При отключённой защите конфиденциальности личные данные владельца домена видны в общедоступной базе данных WHOIS.
Используйте эту конечную точку, чтобы сделать данные владельца домена общедоступными.
-
Method:
DELETE -
Path:
/api/domains/v1/portfolio/{domain}/privacy-protection
domains_getDomainRenewalInformationV1
Получает сведения о продлении указанного домена, в том числе его статус и текущую дату окончания срока действия.
Используйте эту конечную точку для настройки автоматического продления и отслеживания срока действия отдельного домена.
-
Method:
GET -
Path:
/api/domains/v1/portfolio/{domain}/renewal
domains_completeDomainSetupV1
Регистрирует домен, за который вы уже заплатили, но который ещё не был настроен.
Используйте эту конечную точку, если заказ был выполнен, но домен не зарегистрирован. Например, если запрос Purchase new domain вернул 202 Accepted и домен был добавлен в аккаунт без регистрации или если предыдущая попытка настройки завершилась неудачей. Новый заказ не создаётся, и оплата не списывается: используется уже имеющаяся у вас подписка на оплаченный период.
Домен остаётся в статусе ожидания настройки, если на момент выполнения заказа отсутствовали необходимые для регистрации данные или они были указаны неверно. По этой же причине в статусе ожидания настройки могут находиться домены, заказанные в другом месте.
Заполните недостающие данные, затем вызовите эту конечную точку. Если заказ ещё не завершён, домена не будет в вашем аккаунте — дождитесь, пока он появится в Get domain list.
Если параметр domain_contacts не указан, для всех четырёх ролей будет использоваться профиль WHOIS по умолчанию для этой TLD. Профиль должен существовать и содержать все необходимые данные для соответствующей TLD. Чаще всего домен остаётся в статусе ожидания настройки именно из-за неполного профиля. Создайте профиль с помощью Create WHOIS profile.
Для некоторых TLD необходимо указать additional_details. Эти данные проверяются до настройки. Если значение отсутствует или указано неверно, запрос будет отклонён, и попытка регистрации не начнётся.
Домен настраивается с серверами имён по умолчанию и без защиты конфиденциальности. Чтобы изменить эти параметры, после настройки используйте Update domain nameservers и Enable privacy protection.
Успешный ответ означает, что запрос на настройку принят, а не то, что домен уже зарегистрирован. Чтобы узнать результат, проверяйте Get domain list. В Get domain details домен появится только после регистрации.
Используйте эту конечную точку, чтобы завершить регистрацию домена, который в вашем аккаунте ожидает настройки.
-
Method:
POST -
Path:
/api/domains/v1/portfolio/{domain}/setup
domains_updateDomainNameserversV1
Устанавливает серверы имён для указанного домена.
Учтите, что некорректная настройка серверов имён может привести к тому, что домен станет недоступен или перестанет разрешаться.
Используйте эту конечную точку, чтобы настроить для доменов собственный DNS-хостинг.
-
Method:
PUT -
Path:
/api/domains/v1/portfolio/{domain}/nameservers
domains_claimFreeDomainTransferV1
Использует доступный в вашем аккаунте бесплатный перенос домена и запускает процесс переноса.
В отличие от платного переноса, при использовании этой конечной точки расходуется уже доступный вам бесплатный перенос домена, поэтому способ оплаты не требуется.
Перед отправкой запроса разблокируйте домен у текущего регистратора и получите код авторизации. Сначала проверяется возможность переноса: если перенести домен нельзя, запрос будет отклонён, а бесплатный перенос не будет использован.
Успешный ответ означает, что перенос запущен. Срок его завершения зависит от текущего регистратора. Отслеживать ход переноса можно с помощью конечной точки для получения списка переносов.
Если информация WHOIS не указана, будут использованы контактные данные по умолчанию для соответствующей TLD.
Перед отправкой запроса убедитесь, что в вашем аккаунте есть информация WHOIS для нужной TLD.
Если запрос невозможно выполнить, в теле ответа будет возвращён код ошибки.
Используйте эту конечную точку, чтобы перенести домен за счёт бесплатного переноса, доступного в вашем аккаунте.
-
Method:
POST -
Path:
/api/domains/v1/transfers/claim
domains_getTransferV1
Получает сведения о переносе указанного домена.
Используйте эту конечную точку, чтобы отслеживать входящий или исходящий перенос домена между регистраторами и его статус.
-
Method:
GET -
Path:
/api/domains/v1/transfers/{domain}
domains_getTransferListV1
Получает список всех переносов доменов в вашем портфеле.
Используйте эту конечную точку, чтобы отслеживать входящие и исходящие переносы доменов между регистраторами.
-
Method:
GET -
Path:
/api/domains/v1/transfers
domains_changeWHOISProfileForDomainV1
Меняет контактный профиль WHOIS для домена.
Назначает указанные роли контактов новому профилю WHOIS и отправляет изменения в реестр.
Текущий профиль, назначенный этим ролям, определяется автоматически. Запрос завершится ошибкой, если сейчас указанные роли связаны с разными профилями.
Изменение данных владельца, важных для переноса, запускает проверку IRTP.
Изменения обрабатываются асинхронно.
Используйте эту конечную точку, чтобы назначить зарегистрированному домену другие контактные данные.
-
Method:
PUT -
Path:
/api/domains/v1/whois/change
domains_setWHOISProfileAsDefaultV1
Назначает контактный профиль WHOIS профилем по умолчанию.
При регистрации новых доменов этот профиль предварительно выбирается для соответствующей TLD.
Используйте эту конечную точку, чтобы не выбирать контактные данные при каждой регистрации.
-
Method:
PUT -
Path:
/api/domains/v1/whois/default/{whoisId}
domains_unsetDefaultWHOISProfileV1
Отменяет назначение контактного профиля WHOIS профилем по умолчанию.
Сам профиль сохраняется, но больше не выбирается автоматически для соответствующей TLD.
Используйте эту конечную точку, чтобы не применять контактные данные повторно при регистрации новых доменов.
-
Method:
DELETE -
Path:
/api/domains/v1/whois/default/{whoisId}
domains_getWHOISProfileV1
Получает контактный профиль WHOIS.
Используйте эту конечную точку, чтобы просмотреть контактные данные для регистрации доменов.
-
Method:
GET -
Path:
/api/domains/v1/whois/{whoisId}
domains_deleteWHOISProfileV1
Удаляет контактный профиль WHOIS.
Используйте эту конечную точку, чтобы удалить из аккаунта неиспользуемые контактные профили.
-
Method:
DELETE -
Path:
/api/domains/v1/whois/{whoisId}
domains_getWHOISProfileListV1
Получает список контактных профилей WHOIS.
Используйте эту конечную точку, чтобы просмотреть доступные профили с контактными данными для регистрации доменов.
-
Method:
GET -
Path:
/api/domains/v1/whois
domains_createWHOISProfileV1
Создаёт контактный профиль WHOIS.
Используйте эту конечную точку, чтобы добавить новые контактные данные для регистрации доменов.
-
Method:
POST -
Path:
/api/domains/v1/whois
domains_getWHOISProfileUsageV1
Получает список доменов, для которых используется указанный контактный профиль WHOIS.
Используйте эту конечную точку, чтобы узнать, какие домены связаны с определённым контактным профилем.
-
Method:
GET -
Path:
/api/domains/v1/whois/{whoisId}/usage
hostinger-ecommerce-mcp
ecommerce_listDiscountsV1
Возвращает список скидок магазина. Список можно отфильтровать по произвольному тексту в коде или названии скидки, а также по признаку отключения.
Суммы фиксированных скидок задаются целыми числами в наименьших единицах валюты. Процентные скидки задаются целым числом от 1 до 100.
-
Method:
GET -
Path:
/api/ecommerce/v1/stores/{store_id}/discounts
ecommerce_createADiscountV1
Создаёт скидку для магазина. Для фиксированной скидки сумма указывается в наименьших единицах валюты (например, $10 — это 1000). Размер процентной скидки задаётся целым числом от 1 до 100.
Для скидок на бесплатную доставку значение не учитывается. В ответе возвращается созданная скидка.
-
Method:
POST -
Path:
/api/ecommerce/v1/stores/{store_id}/discounts
ecommerce_getCustomStorefrontSetupInstructionsV1
Получить пошаговые инструкции в формате Markdown по подключению собственного канала продаж к магазину и синхронизации каталога, заказов, доставки и платежей через Ecommerce API.
-
Method:
GET -
Path:
/api/ecommerce/v1/miscellaneous/custom-storefront-instructions
ecommerce_cancelAnOrderV1
Отменить заказ и при необходимости отправить клиенту письмо. В ответе возвращается обновлённая сводка по заказу.
-
Method:
POST -
Path:
/api/ecommerce/v1/stores/{store_id}/orders/{order_id}/cancel
ecommerce_fulfilAnOrderV1
Создать отправление для заказа и добавить данные для отслеживания за один вызов. Если не указывать товары, в отправление войдут все оставшиеся необработанные товары. В ответе возвращается обновлённая сводка по заказу.
-
Method:
POST -
Path:
/api/ecommerce/v1/stores/{store_id}/orders/{order_id}/fulfill
ecommerce_listStoreOrdersV1
Получить краткие сведения о заказах магазина, отсортированные от новых к старым. Фильтровать заказы можно по статусу, статусу оплаты или выполнения, электронной почте клиента, номеру заказа или произвольному текстовому запросу. Суммы указаны в минимальных единицах валюты. Чтобы получить позиции заказа, адреса и сведения об отправлениях, запросите отдельный заказ.
-
Method:
GET -
Path:
/api/ecommerce/v1/stores/{store_id}/orders
ecommerce_retrieveAnOrderV1
Получить полную информацию об одном заказе: позиции (у каждой есть идентификатор, необходимый для вызова endpoint выполнения заказа), адреса, разбивку итоговой суммы и отправления с данными для отслеживания. Суммы указаны в минимальных единицах валюты.
-
Method:
GET -
Path:
/api/ecommerce/v1/stores/{store_id}/orders/{order_id}
ecommerce_enableManualPaymentMethodV1
Включить ручной способ оплаты, чтобы магазин мог принимать заказы без онлайн-платёжного провайдера.
-
Method:
POST -
Path:
/api/ecommerce/v1/stores/{store_id}/payment-methods/manual
ecommerce_createAPaymentProviderConnectLinkV1
Создать ссылку для подключения платёжного шлюза к магазину. В ответе возвращаются URL для настройки шлюза, который продавец должен открыть, и deep link на страницу администрирования магазина.
-
Method:
POST -
Path:
/api/ecommerce/v1/stores/{store_id}/payment-providers/{provider_id}/connect-link
ecommerce_listStorePaymentProvidersV1
Получить список платёжных провайдеров магазина. В ответе отдельно перечисляются провайдеры, уже подключённые к магазину, и доступные для установки шлюзы. Учётные данные, секреты и настройки шлюзов не предоставляются.
-
Method:
GET -
Path:
/api/ecommerce/v1/stores/{store_id}/payment-providers
ecommerce_createAProductImageUploadURLV1
Получить подписанный URL для загрузки изображения товара методом POST с типом multipart/form-data. Затем вызовите endpoint добавления изображения, передав возвращённое значение object_name, чтобы проверить и прикрепить изображение к товару.
-
Method:
POST -
Path:
/api/ecommerce/v1/stores/{store_id}/products/{product_id}/images/upload-url
ecommerce_deleteAProductV1
Удалить товар и его варианты из магазина. Товар с подпиской и активными подписчиками не удаляется, а архивируется, чтобы сохранить доступ к его данным.
-
Method:
DELETE -
Path:
/api/ecommerce/v1/stores/{store_id}/products/{product_id}
ecommerce_updateAProductV1
Изменить название, описание или статус товара. Укажите статус published, чтобы товар можно было купить, draft, чтобы скрыть его, или archived, чтобы снять его с продажи. Варианты, цены и остатки настраиваются через endpoints вариантов, а не здесь. В ответе возвращается обновлённая сводка по товару.
-
Method:
PATCH -
Path:
/api/ecommerce/v1/stores/{store_id}/products/{product_id}
ecommerce_createDigitalProductV1
Создать опубликованный цифровой товар с одним вариантом и необязательной внешней ссылкой для скачивания.
-
Method:
POST -
Path:
/api/ecommerce/v1/stores/{store_id}/products/digital
ecommerce_listProductsV1
Получить краткие сведения о товарах магазина, отсортированные от новых к старым: название, статус, миниатюра, количество вариантов и диапазон цен. Цены задаются целыми числами в минимальных единицах валюты и указываются для вариантов. Фильтровать товары можно по статусу, произвольному тексту или списку идентификаторов. Укажите include=variants, чтобы включить в ответ варианты каждого товара с ценами и остатками, или include=media, чтобы включить медиафайлы товара.
-
Method:
GET -
Path:
/api/ecommerce/v1/stores/{store_id}/products
ecommerce_createPhysicalProductV1
Создать опубликованный физический товар с одним вариантом, цена которого указана в валюте магазина.
-
Method:
POST -
Path:
/api/ecommerce/v1/stores/{store_id}/products/physical
ecommerce_uploadAndAttachAProductImageV1
Загрузить растровое изображение (JPEG, PNG, GIF или WebP, размером не более 15 МБ) по URL и прикрепить его к товару за один вызов. Загрузка изображений разрешена только по HTTPS через порт 443 и без встроенных учётных данных. Допускается не более одного перенаправления; его адрес должен соответствовать тем же требованиям. Запросы к частным или зарезервированным сетевым адресам, неподдерживаемые URL и цепочки перенаправлений длиннее одной ссылки отклоняются. Изображение проверяется на вирусы и валидируется по содержимому, после чего сохраняется на CDN. Установите is_thumbnail, чтобы назначить изображение основным для товара.
-
Method:
POST -
Path:
/api/ecommerce/v1/stores/{store_id}/products/{product_id}/images
ecommerce_listSalesChannelsV1
Получить список активных каналов продаж магазина с полной метаинформацией о каждом из них.
-
Method:
GET -
Path:
/api/ecommerce/v1/stores/{store_id}/sales-channels
ecommerce_createASalesChannelV1
Создать канал продаж для магазина. Канал типа "custom" не использует готовую витрину: создайте собственный frontend и синхронизируйте каталог, заказы, доставку и платежи через Ecommerce API. Канал типа "quick-link" — это размещённая на хостинге одностраничная витрина с автоматически сгенерированным идентификатором.
-
Method:
POST -
Path:
/api/ecommerce/v1/stores/{store_id}/sales-channels
ecommerce_updateSalesChannelV1
Изменить канал продаж типа custom. Можно изменить предназначенное для продавца name и публичный url (возвращается как domain канала). Чтобы очистить значение, передайте null.
-
Method:
PATCH -
Path:
/api/ecommerce/v1/stores/{store_id}/sales-channels/{sales_channel_id}
ecommerce_setStoreShippingV1
Установить фиксированную стоимость доставки для магазина. Если зона доставки ещё не создана, она будет создана.
-
Method:
POST -
Path:
/api/ecommerce/v1/stores/{store_id}/shipping
ecommerce_deleteStoreV1
Выполнить мягкое удаление магазина, принадлежащего вашей учётной записи.
Данные магазина сохраняются: он только помечается как удалённый.
-
Method:
DELETE -
Path:
/api/ecommerce/v1/stores/{store_id}
ecommerce_getStoresV1
Получить список магазинов, связанных с вашей учётной записью.
-
Method:
GET -
Path:
/api/ecommerce/v1/stores
ecommerce_createStoreV1
Создать новый магазин для вашей учётной записи.
Одновременно с магазином создаётся основной канал продаж.
-
Method:
POST -
Path:
/api/ecommerce/v1/stores
ecommerce_getStoreMetadataV1
Получить метаданные о готовности магазина: настроены ли способы оплаты и доставка, а также какая валюта используется по умолчанию. Эти сведения помогут проверить необходимые условия перед созданием витрины.
-
Method:
GET -
Path:
/api/ecommerce/v1/stores/{store_id}/metadata
ecommerce_updateProductVariantsInBatchV1
Изменить до 100 существующих вариантов по их идентификаторам: название, остатки, учёт запасов и цены. Варианты, не указанные в запросе, останутся без изменений. Переданные цены полностью заменят текущие цены варианта. В ответе возвращаются обновлённые варианты.
-
Method:
PATCH -
Path:
/api/ecommerce/v1/stores/{store_id}/products/{product_id}/variants/batch
ecommerce_deleteAProductVariantV1
Удалить один вариант товара.
-
Method:
DELETE -
Path:
/api/ecommerce/v1/stores/{store_id}/products/{product_id}/variants/{variant_id}
ecommerce_listProductVariantsV1
Получить список вариантов товара, упорядоченных по рангу, с их параметрами, ценами и остатками. Цены задаются целыми числами в минимальных единицах валюты и указываются для вариантов.
-
Method:
GET -
Path:
/api/ecommerce/v1/stores/{store_id}/products/{product_id}/variants
ecommerce_createAProductVariantV1
Добавить вариант товара с одним или несколькими параметрами (например, размером или цветом). Если в товаре ещё нет указанных параметров, они будут созданы автоматически; для каждого уже существующего параметра нужно передать значение. Цены задаются целыми числами в минимальных единицах валюты и по умолчанию указываются в валюте магазина. В ответе возвращается созданный вариант.
-
Method:
POST -
Path:
/api/ecommerce/v1/stores/{store_id}/products/{product_id}/variants
hostinger-horizons-mcp
horizons_cloneWebsiteV1
Создать копию сайта Hostinger Horizons.\n
Используйте этот инструмент, если пользователь хочет скопировать существующий сайт, например, чтобы проверить изменения, не затрагивая оригинал.\n
Инструмент возвращает идентификатор и URL созданной копии.
Исходный сайт остаётся без изменений.\n
Чтобы редактировать копию, воспользуйтесь инструментом Edit website, передав возвращённый идентификатор сайта, или откройте указанный URL в интерфейсе Hostinger Horizons.
-
Method:
POST -
Path:
/api/horizons/v1/websites/{websiteId}/clone
horizons_getWebsiteListV1
Список сайтов Hostinger Horizons, принадлежащих пользователю.\n
Используйте этот инструмент, если пользователь спрашивает, какие сайты ему принадлежат, или если вам нужен ID сайта
перед его редактированием, публикацией или клонированием.\n
Для каждого сайта возвращаются его ID, статус, домен и URL для открытия сайта
в интерфейсе Hostinger Horizons.\n
Полный список сайтов возвращается одним ответом — разбиения на страницы нет.
-
Метод:
GET -
Путь:
/api/horizons/v1/websites
horizons_createWebsiteV1
Создайте сайт Hostinger Horizons на основе предоставленного сообщения.\n
Используйте этот инструмент, если пользователь просит создать сайт, целевую страницу, блог
или приложение любого другого типа.\n
Инструмент запускает процесс создания сайта и возвращает его URL и ID.
Создание выполняется асинхронно.\n
После вызова этого инструмента ответ в чате должен состоять РОВНО из 1 предложения: сообщите,
что Hostinger Horizons уже создаёт сайт и он будет готов через несколько минут,
и сразу предоставьте пользователю URL сайта.
Не пишите код.\n\nЧтобы отредактировать сайт позднее, воспользуйтесь инструментом Edit website, указав полученный
ID сайта. Пользователь также может открыть сайт в интерфейсе Hostinger Horizons по предоставленному URL.
Если вызов инструмента завершился ошибкой, чётко объясните её причину
и не пишите код самостоятельно в чате.
\n
ОГРАНИЧЕНИЯ ТЕХНОЛОГИЧЕСКОГО СТЕКА (СТРОГО ОБЯЗАТЕЛЬНЫ):\n
Среда поддерживает только следующие технологии.
ЗАПРЕЩЕНО использовать, рекомендовать или реализовывать технологии, не входящие в этот список:\n
\n
-
Язык: ТОЛЬКО JavaScript.
-
TypeScript, Rust, Python, Java, PHP и другие языки СТРОГО ЗАПРЕЩЕНЫ.\n
-
Фреймворк: React.\n
-
Навигация: React Router.\n
-
Стилизация: TailwindCSS.\n
-
Компоненты: shadcn/ui (на базе примитивов @radix-ui).\n
-
Иконки: Lucide React.\n
-
Анимация: Framer Motion.\n
\n
BACKEND И ХРАНЕНИЕ ДАННЫХ:\n
- Встроенный backend Horizons — ЕДИНСТВЕННОЕ допустимое решение для постоянного хранения данных,
аутентификации и работы с базами данных.\n
-
Локальные базы данных (SQLite, MySQL и т. д.) СТРОГО ЗАПРЕЩЕНЫ.\n
-
Сторонние сервисы (Firebase, AWS Amplify) разрешены ТОЛЬКО по прямому запросу пользователя.\n
\n
КАРТЫ:\n
-
Провайдер по умолчанию — OpenStreetMap.\n
-
Альтернативные провайдеры (Google Maps, Mapbox) разрешены ТОЛЬКО по прямому запросу пользователя.\n
-
Метод:
POST -
Путь:
/api/horizons/v1/websites
horizons_editWebsiteV1
Отредактируйте существующий сайт Hostinger Horizons на основе дополнительного сообщения.\n
Используйте этот инструмент, если пользователь хочет изменить, расширить или исправить уже созданный сайт.\n
Инструмент ставит запрошенные изменения в очередь и возвращает URL и ID сайта.
Изменения применяются асинхронно.\n
После вызова этого инструмента ответ в чате должен состоять РОВНО из 1 предложения: сообщите,
что Hostinger Horizons уже применяет запрошенные изменения и они будут готовы
через несколько минут, а также сразу предоставьте пользователю URL сайта.
Не пишите код.\n
Если вызов инструмента завершился ошибкой, чётко объясните её причину
и не пишите код самостоятельно в чате.
-
Метод:
POST -
Путь:
/api/horizons/v1/websites/{websiteId}/messages
horizons_publishWebsiteV1
Опубликуйте сайт Hostinger Horizons, чтобы последние изменения стали доступны пользователям.\n
Используйте этот инструмент, если пользователь просит опубликовать сайт, развернуть его
или сделать доступным в интернете.\n
Инструмент запускает процесс публикации и возвращает URL, по которому сайт станет доступен.
Публикация выполняется асинхронно и занимает несколько минут.\n
После вызова этого инструмента ответ в чате должен состоять РОВНО из 1 предложения: сообщите,
что сайт публикуется, и сразу предоставьте пользователю URL опубликованного сайта.
-
Метод:
POST -
Путь:
/api/horizons/v1/websites/{websiteId}/publish
horizons_getWebsiteV1
Получите ссылку, по которой пользователь сможет открыть сайт в интерфейсе Hostinger Horizons.\n
Используйте этот инструмент, если пользователь запрашивает ссылку на существующий сайт или если вам нужен его
URL до или после редактирования.\n
Сайт можно редактировать с помощью инструмента Edit website или самостоятельно в интерфейсе Hostinger Horizons,
перейдя по предоставленному URL.
-
Метод:
GET -
Путь:
/api/horizons/v1/websites/{websiteId}
hostinger-hosting-mcp
hosting_importWordpressWebsite
Импортируйте сайт WordPress из архивного файла на хостинг-сервер. Инструмент загружает архив сайта (zip, tar, tar.gz и т. д.) и дамп базы данных (файл .sql), чтобы развернуть полноценный сайт WordPress. Архив автоматически распаковывается на сервере. Обратите внимание: для крупных сайтов процесс может занять некоторое время. После завершения загрузки файлы распаковываются, и через несколько минут сайт станет доступен. Данные для загрузки создаются и используются автоматически — не вызывайте отдельный endpoint для получения URL загрузки и не загружайте файлы самостоятельно: инструмент выполняет весь процесс целиком. Имя пользователя определяется автоматически по домену.
-
Метод:
custom -
Путь:
custom
hosting_deployWordpressPlugin
Разверните плагин WordPress из каталога на хостинг-сервере. Инструмент загружает все файлы плагина и запускает его развертывание. Данные для загрузки создаются и используются автоматически — не вызывайте отдельный endpoint для получения URL загрузки и не загружайте файлы самостоятельно: инструмент выполняет весь процесс целиком.
-
Метод:
custom -
Путь:
custom
hosting_deployWordpressTheme
Разверните тему WordPress из каталога на хостинг-сервере. Инструмент загружает все файлы темы и запускает её развертывание. После развертывания загруженную тему можно при необходимости активировать. Данные для загрузки создаются и используются автоматически — не вызывайте отдельный endpoint для получения URL загрузки и не загружайте файлы самостоятельно: инструмент выполняет весь процесс целиком.
-
Метод:
custom -
Путь:
custom
hosting_deployJsApplication
Разверните приложение JavaScript из архивного файла на хостинг-сервере. ВАЖНО: архив должен содержать ТОЛЬКО исходные файлы приложения, но не результат сборки; исключите каталог node_modules, а также все файлы, соответствующие правилам .gitignore, если такой файл существует. После загрузки архива на сервер сборка запустится автоматически. Данные для загрузки создаются и используются автоматически — не вызывайте отдельный endpoint для получения URL загрузки и не загружайте архив самостоятельно: инструмент выполняет весь процесс целиком. После развертывания воспользуйтесь инструментом hosting_listJsDeployments, чтобы проверить статус развертывания и ход сборки.
-
Метод:
custom -
Путь:
custom
hosting_deployStaticWebsite
Разверните статический сайт из архивного файла на хостинг-сервере. ВАЖНО: этот инструмент подходит только для статических сайтов, которым не требуется сборка. Архив должен содержать готовые к публикации статические файлы (HTML, CSS, JavaScript, изображения и т. д.). Если сайт содержит файл package.json или для него нужна команда сборки, воспользуйтесь инструментом hosting_deployJsApplication. Инструмент загружает архив в файловый менеджер сайта по TUS и запускает развертывание; архив распаковывается, а файлы публикуются напрямую, без этапов сборки. Данные для загрузки создаются и используются автоматически — не вызывайте отдельный endpoint для получения URL загрузки и не загружайте архив самостоятельно: инструмент выполняет весь процесс целиком. Имя пользователя определяется автоматически по домену.
-
Метод:
custom -
Путь:
custom
hosting_listJsDeployments
Получите список развертываний приложений JavaScript, чтобы проверить их статус. Используйте этот инструмент, если клиент спрашивает о состоянии развертывания. Инструмент возвращает список развертываний приложений Node.js для домена с разбиением на страницы и позволяет дополнительно отфильтровать результаты по состоянию развертывания.
-
Метод:
custom -
Путь:
custom
hosting_showJsDeploymentLogs
Получите журналы указанного развертывания приложения JavaScript для диагностики причин сбоя.
-
Метод:
custom -
Путь:
custom
hosting_clearWebsiteCacheV1
Полностью и безвозвратно очистите серверный кеш сайта. Используйте этот инструмент, если содержимое сайта обновлено и изменения нужно немедленно сделать видимыми или если были внесены значительные изменения.
Если для сайта включён CDN, инструмент также очищает кеш Hostinger CDN. Для установки WordPress в подкаталоге укажите параметр запроса directory, чтобы очистить кеш этого сайта.
-
Метод:
DELETE -
Путь:
/api/hosting/v1/accounts/{username}/websites/{domain}/cache/clear
hosting_toggleCachelessModeV1
Включите или выключите режим разработки (без кеширования) в соответствии со значением параметра enabled. В этом режиме кеширование полностью отключено, поэтому используйте его во время разработки, тестирования изменений, устранения неполадок или когда нужно сразу видеть обновления. По завершении разработки выключите режим, чтобы вернуть преимущества кеширования для производительности сайта.
-
Метод:
PATCH -
Путь:
/api/hosting/v1/accounts/{username}/websites/{domain}/cacheless-mode/toggle
hosting_toggleWebsiteCacheV1
Включает или отключает кэширование сайта на стороне сервера в зависимости от значения флага. Кэширование ускоряет загрузку страниц, снижает нагрузку на сервер и улучшает пользовательский опыт; рекомендуется для рабочих сайтов.
Отключение кэширования может снизить производительность. Для временного обхода кэша при разработке или отладке лучше переключить сайт в режим без кэширования.
Если кэширование уже настроено нужным образом, ничего не происходит.
-
Method:
PATCH -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/cache/toggle
hosting_listAccountCronJobsV1
Возвращает список заданий cron, настроенных для указанной учётной записи, включая расписание и команду.
-
Method:
GET -
Path:
/api/hosting/v1/accounts/{username}/cron-jobs
hosting_createAccountCronJobV1
Создаёт задание cron для указанной учётной записи на основе выражения расписания и команды.
Возвращает созданное задание cron, включая его uid, необходимый для удаления задания или получения его вывода.
-
Method:
POST -
Path:
/api/hosting/v1/accounts/{username}/cron-jobs
hosting_deleteAccountCronJobV1
Безвозвратно удаляет задание cron с указанным uid.
uid возвращается конечной точкой получения списка заданий cron.
-
Method:
DELETE -
Path:
/api/hosting/v1/accounts/{username}/cron-jobs/{uid}
hosting_getCronJobOutputV1
Возвращает вывод последнего запуска задания cron с указанным uid.
uid возвращается конечной точкой получения списка заданий cron.
-
Method:
GET -
Path:
/api/hosting/v1/accounts/{username}/cron-jobs/{uid}/output
hosting_changeDatabasePasswordV1
Изменяет пароль указанного пользователя базы данных.
Имя базы данных необходимо указывать полностью, в том виде, в котором оно возвращается конечной точкой получения списка баз данных.
Пароль также необходимо обновить в конфигурации каждого сайта, использующего эту базу данных.
-
Method:
PATCH -
Path:
/api/hosting/v1/accounts/{username}/databases/{name}/change-password
hosting_listAccountDatabasesV1
Возвращает постраничный список баз данных указанной учётной записи.
Чтобы найти базы данных, связанные с определённым доменом, используйте фильтры domain и is_assigned.
-
Method:
GET -
Path:
/api/hosting/v1/accounts/{username}/databases
hosting_createAccountDatabaseV1
Создаёт базу данных, пользователя базы данных и пароль для указанной учётной записи.
При необходимости к имени базы данных и имени пользователя автоматически добавляется префикс с именем учётной записи.
-
Method:
POST -
Path:
/api/hosting/v1/accounts/{username}/databases
hosting_deleteAccountDatabaseV1
Безвозвратно удаляет базу данных и связанные с ней удалённые подключения.
Имя базы данных необходимо указывать полностью, в том виде, в котором оно возвращается конечной точкой получения списка баз данных.
-
Method:
DELETE -
Path:
/api/hosting/v1/accounts/{username}/databases/{name}
hosting_createDatabaseRemoteConnectionV1
Разрешает удалённому хосту подключаться к указанной базе данных.
Укажите адрес IPv4/IPv6 или %, чтобы разрешить подключение с любого хоста. Имя базы данных необходимо указывать полностью, в том виде, в котором оно возвращается конечной точкой получения списка баз данных.
-
Method:
POST -
Path:
/api/hosting/v1/accounts/{username}/databases/{name}/remote-connections
hosting_deleteDatabaseRemoteConnectionV1
Безвозвратно удаляет правило удалённого доступа и отзывает разрешение на подключение к базе данных для указанного хоста.
Укажите правило с помощью обязательного параметра запроса ip: адреса IPv4/IPv6 или %. Значение должно в точности совпадать со значением, возвращённым конечной точкой получения списка удалённых подключений. Имя базы данных необходимо указывать полностью, в том виде, в котором оно возвращается конечной точкой получения списка баз данных.
-
Method:
DELETE -
Path:
/api/hosting/v1/accounts/{username}/databases/{name}/remote-connections
hosting_listDatabaseRemoteConnectionsV1
Возвращает правила удалённого доступа для указанной учётной записи: список удалённых хостов, которым разрешено подключаться к базам данных учётной записи. В качестве хостов могут выступать адреса IPv4/IPv6 или %, обозначающий любой хост.
Используйте фильтр domain, чтобы получить только правила для баз данных, связанных с определённым доменом.
-
Method:
GET -
Path:
/api/hosting/v1/accounts/{username}/databases/remote-connections
hosting_repairDatabaseV1
Асинхронно восстанавливает повреждённые таблицы базы данных.
Используйте эту операцию, если сообщается об ошибках, сбоях или повреждении базы данных.
Имя базы данных необходимо указывать полностью, в том виде, в котором оно возвращается конечной точкой получения списка баз данных.
-
Method:
PATCH -
Path:
/api/hosting/v1/accounts/{username}/databases/{name}/repair
hosting_setupWebsiteDatabaseV1
Создаёт новую базу данных MySQL для сайта, записывает данные для подключения в переменные окружения сайта, а затем перезапускает приложение. Платформа генерирует пароль, а также имя базы данных и пользователя, если они не указаны. Пароль не возвращается: приложение получает его из переменных окружения.
Записываемые переменные: DB_HOST, DB_PORT, DB_NAME, DB_USER, DB_PASSWORD и DATABASE_URL (mysql://user:password@host:port/name, имя пользователя и пароль закодированы с помощью percent-encoding).
Существующие переменные сохраняются. Если у сайта уже задана переменная с одним из этих имён, вызов завершится ошибкой 422, и база данных создана не будет. Чтобы удалить эти переменные, используйте конечную точку Replace Node.js environment variables.
После вызова эти переменные становятся обычными переменными окружения. Конечная точка Replace Node.js environment variables изменяет и удаляет их так же, как и любые другие переменные.
Для приложений, которые считывают переменные окружения при запуске процесса, например Express или NestJS, достаточно перезапуска. Фреймворки, встраивающие переменные в результат сборки, например Next.js и NEXT_PUBLIC_*, увидят новые значения только после новой сборки. Для этого используйте конечную точку Start Node.js build.
Пароль из запроса игнорируется: платформа всегда генерирует его самостоятельно. Необязательные параметры name и user задают идентификаторы, а не секреты.
-
Method:
POST -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/databases/setup
hosting_getPhpMyAdminLinkV1
Возвращает прямую ссылку для входа в phpMyAdmin для указанной базы данных.
Используйте эту операцию, когда нужен графический интерфейс для выполнения SQL-запросов, импорта и экспорта данных или управления таблицами.
Имя базы данных необходимо указывать полностью, в том виде, в котором оно возвращается конечной точкой получения списка баз данных.
-
Method:
GET -
Path:
/api/hosting/v1/accounts/{username}/databases/{name}/phpmyadmin-link
hosting_listAvailableDatacentersV1
Возвращает список дата-центров, доступных для настройки тарифных планов хостинга с учётом свободных мощностей и выбранного для заказа тарифа.
Первый элемент списка — наиболее подходящий вариант для условий вашего заказа.
-
Method:
GET -
Path:
/api/hosting/v1/datacenters
hosting_generateAFreeSubdomainV1
Создаёт уникальный бесплатный поддомен, который можно использовать для услуг хостинга без покупки собственного домена.
Бесплатные поддомены позволяют сразу начать пользоваться услугами хостинга. Позже к сайту можно подключить собственный домен.
-
Method:
POST -
Path:
/api/hosting/v1/domains/free-subdomains
hosting_listWebsiteParkedDomainsV1
Возвращает список всех припаркованных доменов и доменов-псевдонимов, созданных для выбранного сайта.
Используйте эту конечную точку, чтобы просмотреть настройки припаркованных доменов для конкретного сайта, включая родительский домен и назначенную каждому припаркованному домену корневую директорию.
-
Method:
GET -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/parked-domains
hosting_createWebsiteParkedDomainV1
Создаёт для выбранного сайта припаркованный домен или домен-псевдоним.
Укажите доменное имя или IP-адрес, который нужно привязать к сайту. Он будет отображать тот же контент, что и родительский домен.
-
Method:
POST -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/parked-domains
hosting_deleteWebsiteParkedDomainV1
Удаляет существующий припаркованный домен или домен-псевдоним с выбранного сайта.
Используйте эту конечную точку, чтобы удалить больше не нужные припаркованные домены.
-
Method:
DELETE -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/parked-domains/{parkedDomain}
hosting_listWebsiteSubdomainsV1
Возвращает список всех поддоменов, созданных для выбранного сайта.
Используйте эту конечную точку, чтобы просмотреть настройки поддоменов для конкретного сайта, включая родительский домен и назначенную каждому поддомену корневую директорию.
-
Method:
GET -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/subdomains
hosting_createWebsiteSubdomainV1
Создаёт новый поддомен для выбранного сайта.
Укажите префикс поддомена и при необходимости — собственную директорию или публичную директорию сайта, которая будет использоваться как корневая.
-
Method:
POST -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/subdomains
hosting_deleteWebsiteSubdomainV1
Удаляет существующий поддомен с выбранного сайта.
Используйте эту конечную точку, чтобы удалить больше не нужные поддомены.
-
Method:
DELETE -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/subdomains/{subdomain}
hosting_verifyDomainOwnershipV1
Проверяет право владения одним доменом и возвращает статус проверки.
Используйте этот endpoint, чтобы убедиться, что домен доступен вам, прежде чем использовать его для нового сайта.
Если домен доступен, в ответе будет is_accessible: true.
Если домен недоступен, добавьте указанную TXT-запись в DNS-настройки домена и повторите проверку.
Учтите, что распространение новых TXT-записей DNS может занять до 10 минут.
Пропустите проверку, если используете бесплатные поддомены Hostinger (*.hostingersite.com).
-
Метод:
POST -
Путь:
/api/hosting/v1/domains/verify-ownership
hosting_generateUploadURLV1
Создаёт URL для загрузки файлов через файловый менеджер и возвращает данные для аутентификации,
которые позволяют напрямую загружать файлы в файловое хранилище сайта.
В ответе возвращаются url, auth_key и rest_auth_key. Используйте их, чтобы загрузить файл
в каталог сайта public_html с помощью протокола возобновляемой загрузки TUS (TUS 1.0.0).
Добавляйте заголовки X-Auth: {auth_key} и X-Auth-Rest: {rest_auth_key} в каждый из запросов,
описанных ниже.
- Создайте загрузку: отправьте
POSTна{url}/{relative_file_path}?override=trueс заголовками
upload-length: {file size in bytes} и upload-offset: 0. Ожидаемый ответ — 201 Created.
- Загрузите файл: отправляйте байты файла по тому же адресу с помощью любого клиента TUS 1.0.0 либо
запросами PATCH, указывая прогресс в заголовке upload-offset, пока загрузка не завершится.
relative_file_path — путь назначения внутри public_html, например app.zip.
Вместо клиента TUS можно использовать обычный curl:
201 Created
curl -i -X PATCH "{url}/${FILE}?override=true"
-H "X-Auth: {auth_key}"
-H "X-Auth-Rest: {rest_auth_key}"
-H "Tus-Resumable: 1.0.0"
-H "Content-Type: application/offset+octet-stream"
-H "Upload-Offset: 0"
--data-binary "@${FILE}"
-> 204 No Content, Upload-Offset response header equals SIZE when done">
FILE=app.zip
SIZE=$(stat -f%z "$FILE") # stat -c%s on Linux
curl -i -X POST "{url}/${FILE}?override=true" \
-H "X-Auth: {auth_key}" \
-H "X-Auth-Rest: {rest_auth_key}" \
-H "Tus-Resumable: 1.0.0" \
-H "Upload-Length: ${SIZE}" \
-H "Upload-Offset: 0"
# -> 201 Created
curl -i -X PATCH "{url}/${FILE}?override=true" \
-H "X-Auth: {auth_key}" \
-H "X-Auth-Rest: {rest_auth_key}" \
-H "Tus-Resumable: 1.0.0" \
-H "Content-Type: application/offset+octet-stream" \
-H "Upload-Offset: 0" \
--data-binary "@${FILE}"
# -> 204 No Content, Upload-Offset response header equals SIZE when done
-
Метод:
POST -
Путь:
/api/hosting/v1/files/upload-urls
hosting_listWebsiteFilesAndDirectoriesV1
Возвращает список файлов и каталогов в корневом каталоге сайта.
Чтобы просмотреть подкаталог относительно корневого каталога сайта, укажите directory. Символические ссылки
отображаются в списке, но по ним нельзя переходить, и они не разрешаются.
-
Метод:
GET -
Путь:
/api/hosting/v1/accounts/{username}/domains/{domain}/files
hosting_getWebsiteFileContentV1
Возвращает содержимое одного файла относительно корневого каталога сайта.
Endpoint доступен только для чтения. Он не возвращает символические ссылки, слишком большие файлы,
файлы не текстовых форматов, а также файлы, распознанные как содержащие секреты (например, файлы с учётными данными).
-
Метод:
GET -
Путь:
/api/hosting/v1/accounts/{username}/domains/{domain}/files/content
hosting_getGitAutoDeploymentSettingsV1
Возвращает настройки автоматического развёртывания Git для сайта: репозиторий и ветку, каталог
для развёртывания и состояние запуска развёртывания при отправке изменений. Если is_enabled имеет значение false,
связь с репозиторием сохраняется, но отправка изменений не приводит к развёртыванию.
Если для сайта не настроено автоматическое развёртывание, все поля имеют значение null. Чтобы сохранить настройки,
используйте Update Git auto-deployment settings.
-
Метод:
GET -
Путь:
/api/hosting/v1/accounts/{username}/websites/{domain}/git/auto-deployments/settings
hosting_updateGitAutoDeploymentSettingsV1
Создаёт или заменяет настройки автоматического развёртывания Git для сайта: репозиторий, ветку, каталог
в корневом каталоге сайта, куда будут развёртываться файлы, и значение is_enabled. Передайте полный набор параметров;
по умолчанию is_enabled имеет значение true, а directory — корневой каталог сайта. Значение installation_uuid
должно соответствовать установке из List Git installations, принадлежащей тому же клиенту, что и сайт.
Для сайтов на PHP и статических сайтов сохранение настроек с is_enabled, равным true, сразу запускает развёртывание ветки.
Каждая последующая отправка изменений в эту ветку также запускает развёртывание. Для сайтов на Node.js и сайтов Website Builder
сохранение настроек не клонирует репозиторий. Для сайта на Node.js запустите первое развёртывание с помощью
Start Node.js build, указав source_type со значением git. Последующие отправки изменений будут запускать новые сборки
с настройками сборки, сохранёнными для сайта.
-
Метод:
PUT -
Путь:
/api/hosting/v1/accounts/{username}/websites/{domain}/git/auto-deployments/settings
hosting_deleteGitAutoDeploymentSettingsV1
Удаляет настройки автоматического развёртывания Git для сайта. Уже развёрнутые файлы остаются на сайте,
но отправка изменений больше не запускает развёртывание, пока настройки не будут заданы повторно. Запрос завершается успешно,
даже если настройки не были заданы.
-
Метод:
DELETE -
Путь:
/api/hosting/v1/accounts/{username}/websites/{domain}/git/auto-deployments/settings
hosting_listGitInstallationsV1
Возвращает список аккаунтов Git-провайдеров, подключённых клиентом. По умолчанию возвращаются только установки
со статусом active, если фильтр status не задаёт другое значение.
Пустой список означает, что у клиента нет активных установок. Также проверьте статусы suspended и
pending. Если установок нет совсем, Git-провайдера (GitHub или GitLab) нужно один раз подключить в hPanel
(в разделах Websites, Manage, Advanced, Git; или Add Website, Node.js Web App,
Import Git Repository). После этого новая установка появится в списке, возвращаемом этим endpoint.
Используйте uuid как параметр пути для List Git installation repositories, а также как значение
installation_uuid в Start Node.js build с source_type git и в Update Git auto-deployment settings.
-
Метод:
GET -
Путь:
/api/hosting/v1/git/installations
hosting_listGitInstallationRepositoriesV1
Возвращает список репозиториев, к которым имеет доступ установка Git. Данные запрашиваются напрямую у провайдера.
Поддерживаются установки github и gitlab. Используйте активную установку: запрос для приостановленной установки
или установки со статусом ожидания также будет отправлен провайдеру, и вызов завершится ошибкой, которую вернёт провайдер.
Список ограничен первыми 500 репозиториями в порядке, заданном провайдером. Если в аккаунте больше репозиториев,
укажите нужный репозиторий напрямую, не выполняя поиск в этом списке.
Параметры owner, name и ветку (default_branch или другую) укажите в source_options для
Start Node.js build или в Update Git auto-deployment settings. Если установка не принадлежит клиенту,
возвращается 404. Ограничение — 10 вызовов в минуту для каждого API-клиента; при превышении возвращается 429.
-
Метод:
GET -
Путь:
/api/hosting/v1/git/installations/{uuid}/repositories
hosting_listNodeJSBuildsV1
Возвращает постраничный список процессов сборки Node.js для указанного сайта.
Каждая сборка соответствует одному запуску конвейера сборки Node.js. Чтобы отфильтровать результаты по состоянию сборки
(pending, running, completed, failed), используйте параметр запроса states.
Используйте uuid сборки, чтобы получать данные о её ходе через endpoint Get Node.js Build Logs.
-
Метод:
GET -
Путь:
/api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/builds
hosting_startNode_jsBuildV1
Запускает сборку Node.js с использованием файлов, уже находящихся в файловом хранилище сайта.
ПРЕДУПРЕЖДЕНИЕ: при успешном выполнении endpoint заменит текущее содержимое сайта. Это действие нельзя отменить,
поэтому перед вызовом убедитесь, что замена необходима.
Если source_type имеет значение archive, параметр source_options.archive_path должен указывать на существующий
архив на сервере относительно корневого каталога сайта. Сначала загрузите архив с помощью endpoint
Generate Upload URL, чтобы получить данные для аутентификации. Чтобы определить настройки сборки по архиву
до её запуска, сначала вызовите endpoint Get Node.js Build Settings from Archive.
Если source_type имеет значение git, параметр source_options должен содержать owner, repository, branch и
installation_uuid. Возьмите установку из List Git installations, а владельца и репозиторий — из
List Git installation repositories. Ветка клонируется в состоянии на момент запроса. Установка должна принадлежать
тому же клиенту, что и сайт.
Возвращённое значение uuid сборки можно использовать, чтобы отслеживать её ход и получать журналы через
endpoint Get Node.js Build Logs.
-
Метод:
POST -
Путь:
/api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/builds
hosting_getNode_jsBuildSettingsV1
Возвращает сохранённые настройки сборки сайта: фреймворк (app_type), версию Node.js,
корневой и выходной каталоги, скрипт сборки, файл точки входа и менеджер пакетов. Сохранённые
настройки используются при автоматической сборке и развертывании через Git. Для сборки,
запущенной через API, применяются значения из запроса. Они сохраняются здесь только в том
случае, если настройки ещё не заданы.
Возвращает 404, пока настройки не будут сохранены после первой сборки или первого обновления.
Используйте этот метод после неудачной сборки, чтобы проверить, правильно ли определены
фреймворк или файл точки входа, а затем исправьте настройки с помощью эндпоинта
Update Node.js build settings.
-
Method:
GET -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/builds/settings
hosting_updateNode_jsBuildSettingsV1
Заменяет сохранённые настройки сборки сайта. Передавайте полный набор значений: node_version
обязателен, а для каждого пропущенного nullable-поля будет сохранено значение null. Если
настроек ещё нет, они будут созданы.
Этот метод не запускает сборку. Сохранённые настройки используются при автоматической сборке
и развертывании через Git. Для сборки, запущенной через API, применяются значения из запроса.
Поэтому, чтобы повторно выполнить сборку с исправленными настройками, вызовите
Start Node.js build, передав те же значения. Типичные исправления: неверный app_type,
определённый автоматически, или отсутствующий entry_file в приложениях на express, fastify,
nest, nuxt и hono.
-
Method:
PUT -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/builds/settings
hosting_getNode_jsBuildSettingsFromArchiveV1
Автоматически определяет настройки сборки Node.js по файлу package.json внутри архива,
который уже находится на сервере.
Используйте этот метод перед вызовом Start Node.js Build, чтобы предварительно посмотреть,
какие настройки будут применены, или дать пользователю возможность проверить и изменить
значения (фреймворк, версия node, корневой каталог, выходной каталог, скрипт сборки)
до запуска сборки.
Архив должен уже находиться в файловом хранилище сайта. Сначала вызовите эндпоинт
Generate Upload URL, чтобы получить учётные данные и загрузить архив.
-
Method:
GET -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/builds/settings/from-archive
hosting_listNode_jsEnvironmentVariablesV1
Возвращает список переменных окружения Node.js, заданных для сайта. Их значения всегда
маскируются как ********, и получить их через этот API нельзя. Используйте этот эндпоинт,
чтобы узнать, какие ключи настроены, или проверить изменения, но не для чтения значений.
Чтобы изменить переменные, используйте эндпоинт Replace Node.js environment variables.
Он заменяет весь набор, поэтому не копируйте замаскированные значения из этого ответа в запрос.
Вместо этого передайте полный требуемый набор с реальными значениями из файла проекта .env
или запроса пользователя.
-
Method:
GET -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/builds/settings/env
hosting_replaceNode_jsEnvironmentVariablesV1
Заменяет переменные окружения Node.js сайта на переданные в запросе. Замена выполняется для
всего набора: любая переменная, отсутствующая в запросе, будет удалена. Если передать пустой
массив env_vars, будут удалены все переменные. При сохранении значения записываются, а
работающий процесс Node.js перезапускается.
Для приложений, которые считывают переменные окружения при запуске процесса, например Express
или NestJS, достаточно перезапуска. Для фреймворков, встраивающих переменные в сборку, этого
недостаточно. К таким приложениям относится Next.js standalone: для применения значений на
этапе сборки, включая NEXT_PUBLIC_*, требуется новая сборка. После вызова этого метода
используйте эндпоинт Start Node.js build, чтобы такие приложения подхватили новые значения.
Эндпоинт List Node.js environment variables возвращает замаскированные значения (********),
поэтому никогда не копируйте их в этот запрос. Всегда передавайте полный требуемый набор
с реальными значениями из файла проекта .env или запроса пользователя.
-
Method:
PUT -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/builds/settings/env
hosting_analyseFailedNode_jsBuildV1
Возвращает AI-анализ причины сбоя сборки и способов его устранения на основе журналов сборки,
списка файлов проекта и package.json. Анализировать можно только сборки в состоянии failed;
для любого другого состояния возвращается 422. Если анализ выполнить не удалось, значения
analysis и solution будут равны null. В этом случае изучите результат Get NodeJS build logs.
При каждом вызове анализ выполняется заново, поэтому вызывайте метод один раз для каждой
неудачной сборки и сохраняйте результат. Ограничение — 5 вызовов в минуту на один API-клиент
(при превышении возвращается 429).
-
Method:
GET -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/builds/{uuid}/analysis
hosting_getNode_jsBuildDetailsV1
Возвращает сведения об одной сборке по UUID: её состояние (pending, running, completed,
failed), использованные параметры и временные метки. Если сборка находится в состоянии
pending или running, периодически проверяйте её состояние. Если сборка завершилась с ошибкой,
изучите журналы с помощью Get NodeJS build logs и выясните причину с помощью
Analyse failed Node.js build.
Возвращает 404, если UUID не относится к сборке этого сайта.
-
Method:
GET -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/builds/{uuid}
hosting_getNodeJSBuildLogsV1
Возвращает журналы конкретного процесса сборки Node.js.
Чтобы получать вывод в реальном времени во время сборки, вызывайте этот эндпоинт повторно,
пока сборка находится в состоянии running. Передавайте количество строк lines из предыдущего
ответа в параметре from_line, чтобы получить только новые строки, появившиеся после прошлого
вызова.
Журналы могут содержать управляющие последовательности ANSI (цветовые коды).
-
Method:
GET -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/builds/{uuid}/logs
hosting_getNode_jsRuntimeLogsV1
Возвращает записи консольного журнала приложения Node.js в хронологическом порядке, от старых
к новым. Каждая запись содержит временную метку, уровень и сообщение. При первом вызове
передайте period (1h, 1d, 1w или 1m), а также при необходимости levels и limit
(от 1 до 5000, по умолчанию — 1000). Если подходящих записей больше, чем указано в limit,
будут оставлены самые новые.
Чтобы получать новые записи, передайте в from_line значение total_lines + 1 из предыдущего
ответа и не указывайте period. Параметры period и from_line нельзя использовать вместе.
Строки, не являющиеся JSON с временной меткой, уровнем и сообщением, пропускаются, поэтому
в logs может быть меньше записей, чем задано в limit, хотя total_lines учитывает все
исходные строки. Записи с временной меткой раньше last_deployed_at относятся к предыдущему
развертыванию. Если приложение ещё не создало файл журнала, возвращается пустой список logs.
-
Method:
GET -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/runtime-logs
hosting_clearNode_jsRuntimeLogsV1
Очищает файл журнала приложения Node.js. Это действие нельзя отменить, поэтому перед вызовом
получите подтверждение пользователя. Метод возвращает успешный результат, даже если файл
журнала ещё не создан.
Используйте его перед воспроизведением проблемы, чтобы при следующем вызове
Get Node.js runtime logs получить только новые записи. После очистки начните вызов снова
с параметром period, а не с прежним значением from_line.
-
Method:
DELETE -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/runtime-logs
hosting_restartNode_jsApplicationV1
Перезапускает серверный процесс Node.js для сайта. Не пересобирает и не развертывает приложение.
Используйте этот метод, чтобы применить изменения переменных окружения или конфигурации либо
восстановить работу зависшего приложения.
Метод применим только к приложениям с серверной частью (Express, Next.js, NestJS и т. д.).
У статических фронтенд-приложений (React, Vue, Vite) нет постоянно работающего серверного
процесса, поэтому перезапуск на них не повлияет. Метод возвращает успешный результат, даже
если на сайте нет серверного процесса для перезапуска.
-
Method:
POST -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/server/restart
hosting_listNode_jsVulnerabilitiesV1
Возвращает список известных уязвимостей npm-пакетов, обнаруженных на сайте Node.js, с
дополнительными данными из рекомендаций по безопасности: уровень критичности, оценка CVSS,
CVE и URL рекомендации. Результаты отсортированы от наиболее серьёзных уязвимостей к наименее
серьёзным, а затем по дате публикации — от новых к старым. Используйте параметр запроса
severities, чтобы отфильтровать результаты.
Уязвимости с is_patchable, равным true, можно устранить автоматически с помощью эндпоинта
Patch Node.js Vulnerabilities. Он создаёт pull request в GitHub с обновлёнными версиями
пакетов. Автоматическое исправление доступно только для сайтов, развернутых из подключённого
репозитория GitHub. Уязвимости с is_patching_in_progress, равным true, уже включены в
открытый pull request с исправлениями. Пока такой pull request открыт, новые запросы на
исправление для этого сайта отклоняются — сначала его нужно объединить или закрыть.
Данные поступают из периодического сканирования зависимостей, поэтому могут не учитывать
последнее развертывание. Пустой список означает, что при последнем сканировании уязвимости
не обнаружены, но не гарантирует их отсутствие в текущем развертывании. Функция доступна
в тарифных планах Business и Cloud Hosting.
-
Method:
GET -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/vulnerabilities
hosting_patchNode_jsVulnerabilitiesV1
Устраняет выбранные уязвимости Node.js, обновляя версии затронутых пакетов в package.json
и создавая pull request в GitHub в подключённом репозитории. Клиент проверяет и объединяет pull request; после объединения автоматически запускается развёртывание.
Автоматическое исправление доступно только для сайтов, развёрнутых из подключённого репозитория GitHub.
Для сайтов, развёрнутых из архива, автоматическое исправление недоступно: запрос возвращает 404. Приложению Hostinger GitHub App необходимы права на запись в репозиторий; если таких прав нет, запрос завершается ошибкой 403 с указанием отсутствующего разрешения.
Исправить можно только уязвимости, у которых параметр is_patchable имеет значение true. Идентификаторы неисправляемых уязвимостей в выбранном списке пропускаются; pull request включает только уязвимости, которые можно исправить. Их идентификаторы перечислены в patched_vulnerability_ids. Если среди выбранных уязвимостей нет ни одной исправляемой, запрос отклоняется с ошибкой 422. Для одного сайта одновременно может быть открыт только один pull request с исправлениями. Чтобы создать новый, сначала закройте или объедините текущий. Функция доступна на тарифах Business и Cloud Hosting.
-
Method:
POST -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/vulnerabilities/patch
hosting_listOrdersV1
Возвращает постраничный список заказов, доступных аутентифицированному клиенту.
Этот endpoint предоставляет доступ к заказам ваших аккаунтов хостинга, а также к заказам аккаунтов других клиентов, которые открыли для вас общий доступ.
Используйте доступные параметры запроса, чтобы отфильтровать результаты по статусам заказов или конкретным идентификаторам и получить более точный список.
-
Method:
GET -
Path:
/api/hosting/v1/orders
hosting_resetPHPExtensionsV1
Сбрасывает все PHP-расширения сайта до настроек по умолчанию.
Используйте этот endpoint, чтобы устранить конфликты расширений или восстановить исходную конфигурацию.
-
Method:
PATCH -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/php/extensions/reset
hosting_getPHPDetailsV1
Возвращает полную конфигурацию PHP для сайта: текущую версию и доступные версии (поддерживаемые и неподдерживаемые), включённые и отключённые расширения, а также параметры с их текущими и стандартными значениями, типами и лимитами тарифного плана (max). Кроме того, возвращаются группы конфликтующих расширений.
Используйте этот endpoint, чтобы проверить текущие настройки PHP перед изменением версии, расширений или параметров.
-
Method:
GET -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/php/details
hosting_getPHPInfoV1
Возвращает полную страницу phpinfo для сайта в формате HTML.
Используйте этот endpoint для диагностики проблем PHP или просмотра полной информации о среде PHP сайта.
-
Method:
GET -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/php/php-info
hosting_updatePHPExtensionsV1
Включает или отключает PHP-расширения (модули) сайта.
Перед изменением настроек используйте endpoint Get PHP details, чтобы проверить текущее состояние расширений.
-
Method:
PATCH -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/php/extensions
hosting_updatePHPOptionsV1
Изменяет параметры PHP для сайта, например memory_limit, max_execution_time и upload_max_filesize.
В объекте options указывайте только те параметры, которые хотите изменить.
Значения, превышающие лимит тарифного плана аккаунта, автоматически ограничиваются этим лимитом. Поэтому запрос может завершиться успешно, даже если применённое значение окажется ниже указанного. После изменения вызовите endpoint Get PHP details, чтобы узнать фактическое значение.
-
Method:
PATCH -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/php/options
hosting_updatePHPVersionV1
Изменяет версию PHP сайта.
Используйте endpoint Get PHP details, чтобы узнать, какие версии доступны для сайта.
-
Method:
PATCH -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/php/version
hosting_listWebsiteRedirectsV1
Возвращает постраничный список перенаправлений, настроенных для выбранного сайта.
-
Method:
GET -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/redirects
hosting_createWebsiteRedirectV1
Создаёт перенаправление с URL выбранного сайта на другой URL или IP-адрес.
-
Method:
POST -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/redirects
hosting_deleteWebsiteRedirectV1
Безвозвратно удаляет перенаправление, указанное исходным URL.
Передавайте значение from в точности в том виде, в котором оно возвращается endpoint со списком перенаправлений.
-
Method:
DELETE -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/redirects
hosting_installSSLV1
Запрашивает установку бессрочного SSL-сертификата для сайта. Установка выполняется в фоновом режиме; после её завершения endpoint Get SSL status возвращает статус active или failed. Запрос можно выполнить, даже если бессрочный сертификат уже активен: в этом случае запускается его переустановка.
Запрос возвращает ошибку 422 для бесплатных поддоменов, сертификат которых обслуживается платформой; во время установки со статусом installing или waiting_for_retry; если сертификат сайта был отозван и не может быть выпущен повторно; а также если установлен загруженный пользователем сертификат. В последнем случае сначала необходимо удалить этот сертификат.
-
Method:
POST -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/ssl/setup
hosting_getSSLStatusV1
Возвращает состояние SSL для сайта: статус сертификата status и его поставщика provider, сведения о том, является ли сертификат бессрочным и обслуживается ли платформой, информацию о перенаправлении HTTP-запросов на HTTPS, сроке действия сертификата и последней ошибке установки.
Статусы installing и waiting_for_retry означают, что установка выполняется. Статус failed указывает, что последняя попытка установки завершилась неудачей или сайт не обновлялся в течение 60 минут, пока находился в статусе installing. Если причина ошибки известна, она указывается в last_error; в противном случае значение этого поля — null. Статус expired означает, что срок действия назначенного сертификата истёк. Статус not_installed означает, что сертификат не назначен. Для бесплатных поддоменов используется сертификат, которым управляет платформа: если сведения об установке отсутствуют, возвращается статус active, а поля provider и expires_at имеют значение null.
-
Method:
GET -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/ssl/status
hosting_toggleHTTPSRedirectV1
Включает или отключает перенаправление сайта с HTTP на HTTPS в соответствии со значением is_enabled. Если перенаправление уже настроено нужным образом, никаких действий не выполняется. Для включения перенаправления необходимо, чтобы сертификат был установлен: endpoint Get SSL status должен возвращать статус active или expired. Если сертификата нет, запрос завершается ошибкой 422. Отключить перенаправление можно в любом случае.
-
Method:
PATCH -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/ssl/https-redirect/toggle
hosting_uninstallSSLV1
Удаляет SSL-сертификат, назначенный сайту, отключает перенаправление на HTTPS и отменяет повторную попытку установки, если она ожидает выполнения. До завершения новой установки сайт будет работать по обычному HTTP. Сразу после выполнения запроса endpoint Get SSL status возвращает not_installed. Запрос выполняется успешно и в том случае, если сертификат не назначен, поэтому его можно безопасно вызывать повторно.
Запрос возвращает ошибку 422 для бесплатных поддоменов, сертификат которых обслуживается платформой, а также во время установки со статусом installing.
-
Method:
DELETE -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/ssl
hosting_listWebsitesV1
Возвращает постраничный список сайтов (CloudLinux, Builder и Horizons), доступных аутентифицированному клиенту.
Этот endpoint предоставляет доступ к сайтам из ваших аккаунтов хостинга, а также к сайтам из аккаунтов других клиентов, которые открыли для вас общий доступ.
В данных каждого сайта есть поле website_type, которое указывает тип сайта, определённый на платформе: wordpress, builder, horizons, nodejs или other. Некоторые поля, например vhost_type, username и root_directory, применяются только к сайтам CloudLinux; для других платформ их значения равны null.
Используйте параметр website_types, чтобы получить сайты только определённого типа, например только сайты WordPress (website_types=wordpress) или Node.js (website_types=nodejs). Для более точной выборки сочетайте его с другими доступными параметрами запроса: фильтруйте результаты по имени пользователя, идентификатору заказа, статусу активности или доменному имени.
-
Method:
GET -
Path:
/api/hosting/v1/websites
hosting_createWebsiteV1
Создаёт новый сайт для аутентифицированного клиента.
Чтобы создать сайт, укажите доменное имя и связанный с ним идентификатор заказа.
Параметр datacenter_code обязателен при создании первого сайта на новом тарифном плане хостинга: он задаёт дата-центр для настройки нового аккаунта хостинга.
Последующие сайты автоматически размещаются в том же дата-центре.
Создание сайта может занять несколько минут. Проверяйте список сайтов, чтобы узнать, когда новый сайт станет доступен.
-
Method:
POST -
Path:
/api/hosting/v1/websites
hosting_deployStaticSiteArchiveV1
Развернуть статическое приложение из файла архива.
ПРЕДУПРЕЖДЕНИЕ: это действие перезапишет текущее содержимое сайта, и его нельзя будет отменить.
Перед вызовом этого endpoint убедитесь, что пользователь действительно хочет продолжить.
Этот endpoint позволяет развернуть статическое приложение из файла архива, загруженного в каталог сайта.
Работает только со статическими сайтами — заранее собранными проектами на HTML/CSS/JS, для которых не требуется сборка. Для приложений Node.js используйте Create NodeJS build from archive, а если архив уже загружен — Start Node.js build. Для сайтов WordPress используйте Import WordPress website.
-
Метод:
POST -
Путь:
/api/hosting/v1/accounts/{username}/websites/{domain}/deploy
hosting_deleteWebsiteV1
Этот endpoint безвозвратно удаляет сайт и все связанные с ним данные. Отменить это действие нельзя. Прежде чем вызывать endpoint, убедитесь, что пользователь понимает последствия и явно подтвердил, что хочет продолжить.
Все файлы сайта, базы данных и связанные настройки будут удалены.
Тарифный план хостинга сохранится, поэтому на нём можно будет создать новый сайт.
Поддерживаются основные и дополнительные домены на тарифах веб-хостинга, а также сайты Website Builder. С этим endpoint нельзя удалять припаркованные домены и поддомены. Укажите точный домен сайта, а не домен предпросмотра или псевдоним.
Возвращает 404, если домен не существует или не принадлежит аутентифицированному клиенту.
Удаление сайта выполняется асинхронно и может занять несколько минут. Ответ возвращается до завершения удаления.
-
Метод:
DELETE -
Путь:
/api/hosting/v1/websites/{domain}
hostinger-mail-mcp
mail_createAliasV1
Создать псевдоним для указанного почтового ящика. Адрес псевдонима формируется из заданной локальной части и домена почтового ящика. Сообщения, отправленные на этот адрес, доставляются в почтовый ящик.
-
Метод:
POST -
Путь:
/api/mail/v1/mailboxes/{mailboxId}/aliases
mail_deleteAliasV1
Удалить псевдоним. Сообщения, отправленные на его адрес, больше не будут доставляться в почтовый ящик.
-
Метод:
DELETE -
Путь:
/api/mail/v1/aliases/{aliasId}
mail_listAliasesV1
Получить постраничный список псевдонимов для всех почтовых ящиков в заказе на почтовый сервис.
-
Метод:
GET -
Путь:
/api/mail/v1/orders/{orderId}/aliases
mail_createAPITokenV1
Создать API-токен для указанного заказа на почтовый сервис. Токен предоставляет доступ к Hostinger Email API, с помощью которого можно создавать и управлять почтовыми ящиками, включёнными в область его действия.
Токен в открытом виде возвращается только в этом ответе и больше не отображается.
Для одного заказа можно создать не более 10 токенов. Используйте scope.has_all_mailboxes, чтобы включить в область действия все текущие и будущие почтовые ящики, или перечислите конкретные ящики в scope.mailbox_ids.
-
Метод:
POST -
Путь:
/api/mail/v1/orders/{orderId}/api-tokens
mail_revokeAPITokenV1
Отозвать API-токен. После этого он сразу теряет доступ к Hostinger Email API. Отменить это действие нельзя.
-
Метод:
DELETE -
Путь:
/api/mail/v1/api-tokens/{tokenId}
mail_listAPITokensV1
Получить постраничный список токенов Hostinger Email API для всех ваших заказов на почтовый сервис. При необходимости список можно отфильтровать по заказу. Токены в открытом виде не включаются в ответ — они доступны только при создании.
-
Метод:
GET -
Путь:
/api/mail/v1/api-tokens
mail_createAutoreplyV1
Создать автоматический ответ для указанного почтового ящика. Для одного ящика можно настроить только один автоматический ответ. Не указывайте starts_at, чтобы включить его немедленно, и не указывайте ends_at, чтобы оставить его активным бессрочно.
-
Метод:
POST -
Путь:
/api/mail/v1/mailboxes/{mailboxId}/autoreplies
mail_updateAutoreplyV1
Заменить автоматический ответ, указав его содержимое и расписание. Если не указать необязательное поле, его значение будет сброшено: не указывайте starts_at, чтобы включить ответ немедленно, и не указывайте ends_at, чтобы оставить его активным бессрочно.
-
Метод:
PUT -
Путь:
/api/mail/v1/autoreplies/{autoreplyId}
mail_deleteAutoreplyV1
Удалить автоматический ответ почтового ящика. После этого ящик сразу перестанет отправлять автоматические ответы.
-
Метод:
DELETE -
Путь:
/api/mail/v1/autoreplies/{autoreplyId}
mail_listAutorepliesV1
Получить постраничный список автоматических ответов для всех почтовых ящиков в заказе на почтовый сервис.
-
Метод:
GET -
Путь:
/api/mail/v1/orders/{orderId}/autoreplies
mail_createCatchAllV1
Создать правило catch-all, которое перенаправляет все сообщения, отправленные на неизвестные адреса домена, в указанный почтовый ящик. На адрес этого ящика будет отправлено письмо для подтверждения. Правило начнёт действовать только после подтверждения. Для одного домена можно настроить только одно правило catch-all.
-
Метод:
POST -
Путь:
/api/mail/v1/mailboxes/{mailboxId}/catchalls
mail_deleteCatchAllV1
Удалить правило catch-all. Сообщения, отправленные на неизвестные адреса домена, больше не будут перенаправляться в почтовый ящик.
-
Метод:
DELETE -
Путь:
/api/mail/v1/catchalls/{catchallId}
mail_listCatchAllsV1
Получить постраничный список правил catch-all для всех почтовых ящиков в заказе на почтовый сервис.
-
Метод:
GET -
Путь:
/api/mail/v1/orders/{orderId}/catchalls
mail_resendCatchAllConfirmationV1
Повторно отправить письмо для подтверждения на адрес почтового ящика, указанного для неподтверждённого правила catch-all.
-
Метод:
POST -
Путь:
/api/mail/v1/catchalls/{catchallId}/confirmation/resend
mail_createForwarderV1
Создать перенаправление сообщений из указанного почтового ящика на адрес назначения. На адрес назначения будет отправлено письмо для подтверждения. Перенаправление начнёт действовать только после подтверждения.
-
Метод:
POST -
Путь:
/api/mail/v1/mailboxes/{mailboxId}/forwarders
mail_deleteForwarderV1
Удалить перенаправление. После этого почтовый ящик сразу перестанет пересылать сообщения на адрес назначения.
-
Метод:
DELETE -
Путь:
/api/mail/v1/forwarders/{forwarderId}
mail_listForwardersV1
Получить постраничный список перенаправлений для всех почтовых ящиков в заказе на почтовый сервис.
-
Метод:
GET -
Путь:
/api/mail/v1/orders/{orderId}/forwarders
mail_resendForwarderConfirmationV1
Повторно отправить письмо для подтверждения на адрес назначения неподтверждённого перенаправления.
-
Метод:
POST -
Путь:
/api/mail/v1/forwarders/{forwarderId}/confirmation/resend
mail_updateForwarderKeepCopySettingV1
Включить или отключить сохранение копий перенаправленных сообщений в почтовом ящике.
-
Метод:
PATCH -
Путь:
/api/mail/v1/forwarders/{forwarderId}/keep-copy
mail_listAccessLogsV1
Получить постраничный список журналов доступа для домена, связанного с указанным заказом на почтовый сервис. Поддерживается фильтрация по учётной записи, диапазону дат, протоколу, статусу и признаку удаления. Результаты сортируются по времени в порядке убывания.
-
Метод:
GET -
Путь:
/api/mail/v1/orders/{orderId}/logs/access
mail_listActionLogsV1
Получить постраничный список журналов действий учётных записей — административных и пользовательских — для указанного заказа на почтовый сервис. Поддерживается фильтрация по учётной записи, диапазону дат и статусу. Результаты сортируются по времени в порядке убывания.
-
Метод:
GET -
Путь:
/api/mail/v1/orders/{orderId}/logs/action
mail_listInboundLogsV1
Получить постраничный список журналов доставки входящих сообщений для домена, связанного с указанным заказом на почтовый сервис. Поддерживается фильтрация по учётной записи, диапазону дат, статусу, отправителю и получателю. Результаты сортируются по времени в порядке убывания.
-
Метод:
GET -
Путь:
/api/mail/v1/orders/{orderId}/logs/inbound
mail_listMailboxActionLogsV1
Получить постраничный список журналов событий почтового ящика — действий с сообщениями и ящиком — для указанного заказа на почтовый сервис. Адрес ящика должен принадлежать домену заказа. Поддерживается фильтрация по диапазону дат и типу события. Результаты сортируются по времени в порядке убывания.
-
Метод:
GET -
Путь:
/api/mail/v1/orders/{orderId}/logs/mailbox-actions
mail_listOutboundLogsV1
Получить постраничный список журналов доставки исходящих сообщений для домена, связанного с указанным заказом на почтовый сервис. Поддерживается фильтрация по учётной записи, диапазону дат, статусу, отправителю и получателю. Результаты сортируются по времени в порядке убывания.
-
Метод:
GET -
Путь:
/api/mail/v1/orders/{orderId}/logs/outbound
mail_listMailboxesV1
Получить постраничный список почтовых ящиков, относящихся к заказу на почтовый сервис. Используйте этот endpoint для мониторинга ящиков: он возвращает их статусы, включённые протоколы, количество связанных ресурсов и периодически синхронизируемые данные об использовании. Данные об использовании могут обновляться с задержкой и отличаться от текущих значений.
-
Метод:
GET -
Путь:
/api/mail/v1/orders/{orderId}/mailboxes
mail_createMailboxV1
Создать почтовый ящик в рамках указанного заказа на почтовый сервис. Полный адрес формируется из заданной локальной части и домена заказа.
-
Метод:
POST -
Путь:
/api/mail/v1/orders/{orderId}/mailboxes
mail_deleteMailboxV1
Удалить почтовый ящик. Сначала он будет удалён мягким способом и в течение ограниченного срока останется доступен для восстановления. По истечении этого срока ящик будет удалён окончательно.
-
Метод:
DELETE -
Путь:
/api/mail/v1/mailboxes/{mailboxId}
mail_changeMailboxPasswordV1
Изменить пароль почтового ящика.
-
Метод:
PATCH -
Путь:
/api/mail/v1/mailboxes/{mailboxId}/password
mail_listOrdersV1
Получить постраничный список заказов на почтовые услуги, связанных с вашей учётной записью.
Используйте эту конечную точку, чтобы отслеживать состояние почтовых услуг, включая их статус, тарифный план, привязанный домен и срок действия.
-
Метод:
GET -
Путь:
/api/mail/v1/orders
mail_getOrderPlanV1
Получить тарифный план, по которому был оформлен указанный заказ на почтовые услуги, включая квоты и ограничения для домена и почтовых ящиков, а также доступность протоколов.
-
Метод:
GET -
Путь:
/api/mail/v1/orders/{orderId}/plan
mail_createWebhookV1
Создать webhook для указанного почтового ящика. Секрет создаётся при запросе и возвращается только в ответе на него. При каждой отправке уведомления секрет передаётся как bearer-токен.
-
Метод:
POST -
Путь:
/api/mail/v1/mailboxes/{mailboxId}/webhooks
mail_listWebhookDeliveryLogsV1
Получить постраничный список журналов доставки webhook для указанного заказа на почтовые услуги. В журнале указаны результат доставки, её продолжительность и количество повторных попыток.
Можно отфильтровать записи по почтовому ящику.
-
Метод:
GET -
Путь:
/api/mail/v1/orders/{orderId}/webhooks/delivery-logs
mail_getWebhookV1
Получить сведения об одном webhook. Секрет webhook не включается в ответ: его можно получить только при создании webhook или повторной генерации секрета.
-
Метод:
GET -
Путь:
/api/mail/v1/webhooks/{webhookId}
mail_deleteWebhookV1
Безвозвратно удалить webhook. Это действие нельзя отменить. После удаления URL перестанет получать уведомления о событиях.
-
Метод:
DELETE -
Путь:
/api/mail/v1/webhooks/{webhookId}
mail_updateWebhookV1
Частично обновить webhook. Изменяются только поля, переданные в теле запроса; значения пропущенных полей остаются прежними. Чтобы очистить описание, передайте "description": null.
-
Метод:
PATCH -
Путь:
/api/mail/v1/webhooks/{webhookId}
mail_listWebhooksV1
Получить постраничный список webhook для указанного заказа на почтовые услуги. Можно отфильтровать список по почтовому ящику и статусу. Секрет webhook не включается в ответ: его можно получить только при создании webhook или повторной генерации секрета.
-
Метод:
GET -
Путь:
/api/mail/v1/orders/{orderId}/webhooks
mail_regenerateWebhookSecretV1
Повторно сгенерировать секрет webhook. Предыдущий секрет сразу станет недействительным. Новый секрет возвращается только в ответе на этот запрос и при каждой отправке уведомления передаётся как bearer-токен.
-
Метод:
POST -
Путь:
/api/mail/v1/webhooks/{webhookId}/regenerate-secret
mail_testWebhookV1
Отправить тестовое уведомление на URL webhook и получить результат. Частота тестовых запросов ограничивается на вышестоящем уровне.
-
Метод:
POST -
Путь:
/api/mail/v1/webhooks/{webhookId}/test
hostinger-reach-mcp
reach_getAutomationDetailsV1
Получить сведения об одной автоматизации, включая количество контактов, которые начали её проходить, проходят её сейчас, завершили или не смогли пройти до конца.
Эти сведения описывают саму автоматизацию. Чтобы посмотреть выполняемый ею рабочий процесс, используйте конечную точку со списком шагов.
-
Метод:
GET -
Путь:
/api/reach/v1/profiles/{profileUuid}/automations/{automationUuid}
reach_listAutomationsV1
Получить постраничный список автоматизаций профиля.
Для каждой автоматизации указано количество контактов, которые начали её проходить, проходят её сейчас, завершили или не смогли пройти до конца. Эти значения описывают путь контактов, а не показатели взаимодействия с письмами. Чтобы получить данные об открытиях, переходах по ссылкам и отписках, используйте конечную точку статистики кампании.
-
Метод:
GET -
Путь:
/api/reach/v1/profiles/{profileUuid}/automations
reach_listAutomationStepsV1
Получить рабочий процесс автоматизации в виде плоского списка шагов.
Шаги образуют дерево, а не линейную последовательность: используйте parent_uuid, чтобы восстановить ветви, и step_order, чтобы упорядочить шаги с одним родительским элементом. Если у автоматизации пока нет шагов, возвращается пустой список.
-
Метод:
GET -
Путь:
/api/reach/v1/profiles/{profileUuid}/automations/{automationUuid}/steps
reach_getCampaignDetailsV1
Получить сведения об одной кампании: отправителя, тему, ссылку на шаблон, параметры выбора аудитории и ход доставки.
Эти сведения описывают настройки кампании и её текущий статус отправки. Чтобы получить данные об открытиях, переходах по ссылкам и отписках, используйте конечную точку статистики кампании.
-
Метод:
GET -
Путь:
/api/reach/v1/profiles/{profileUuid}/campaigns/{campaignUuid}
reach_listCampaignsV1
Получить постраничный список кампаний профиля.
Для каждой кампании указаны основные показатели взаимодействия. Чтобы найти черновики, запланированные, отправляемые или отправленные кампании, используйте фильтр по статусу. Обратите внимание: у полностью отправленной кампании статус publish. По умолчанию возвращаются только обычные кампании. Передайте type, чтобы получить письма, отправленные автоматизациями, или подтверждения двойного согласия на подписку.
-
Метод:
GET -
Путь:
/api/reach/v1/profiles/{profileUuid}/campaigns
reach_createADraftCampaignV1
Создать кампанию в профиле.
Кампания создаётся как черновик: письма не отправляются, контакты не затрагиваются. Аудитория также не задаётся. Выбор аудитории и планирование отправки не входят в этот запрос: черновик завершают и отправляют через интерфейс Reach.
-
Метод:
POST -
Путь:
/api/reach/v1/profiles/{profileUuid}/campaigns
reach_getCampaignPerformanceV1
Получить показатели кампании: доставку, открытия, переходы по ссылкам и отписки, а также соответствующие коэффициенты.
В каждом показателе учитываются уникальные контакты, а не отдельные события. Например, если один контакт открыл одно письмо пять раз, он будет учтён один раз.
-
Метод:
GET -
Путь:
/api/reach/v1/profiles/{profileUuid}/campaigns/{campaignUuid}/statistics
reach_deleteAContactV1
Удалить контакт с указанным UUID.
Эта конечная точка безвозвратно удаляет контакт из системы email-маркетинга.
Устарело. Эта конечная точка не позволяет указать профиль, поэтому всегда использует профиль клиента по умолчанию и не может удалять контакты из других профилей. Вместо неё используйте DELETE /api/reach/v1/profiles/{profileUuid}/contacts/{contactUuid}.
-
Метод:
DELETE -
Путь:
/api/reach/v1/contacts/{uuid}
reach_deleteAContactFieldV1
Удалить пользовательское поле контакта.
Вместе с полем удаляются все сохранённые в нём значения контактов, а для полей с вариантами выбора — также и сами варианты. Контакты при этом не затрагиваются.
-
Метод:
DELETE -
Путь:
/api/reach/v1/profiles/{profileUuid}/contacts/fields/{fieldUuid}
reach_updateAContactFieldV1
Переименовать пользовательское поле контакта и, для полей с вариантами выбора, заменить список вариантов.
Варианты с UUID сохраняются и получают новые подписи; варианты без UUID создаются заново. Все существующие варианты, не включённые в новый список, удаляются вместе со значениями, которые контакты хранят для них. Тип поля и его slug изменить нельзя.
-
Метод:
PATCH -
Путь:
/api/reach/v1/profiles/{profileUuid}/contacts/fields/{fieldUuid}
reach_listContactFieldsV1
Получить список пользовательских полей контактов, заданных в профиле.
Пользовательские поля позволяют хранить дополнительные атрибуты контактов. UUID из ответа передаются в конечную точку обновления контакта для установки значений. Для полей с вариантами выбора также возвращается список доступных вариантов.
-
Метод:
GET -
Путь:
/api/reach/v1/profiles/{profileUuid}/contacts/fields
reach_createAContactFieldV1
Создать новое пользовательское поле контакта в профиле.
Значение slug формируется на основе подписи. Как и тип поля, его нельзя изменить позднее. Используйте возвращённый UUID, чтобы задавать значения для контактов.
-
Метод:
POST -
Путь:
/api/reach/v1/profiles/{profileUuid}/contacts/fields
reach_listContactGroupsV1
Получить список всех групп контактов.
Эта конечная точка возвращает группы, которые можно использовать для организации контактов.
-
Метод:
GET -
Путь:
/api/reach/v1/contacts/groups
reach_listContactsV1
Получить постраничный список контактов с базовой информацией. При необходимости список можно отфильтровать по группе и статусу подписки.
Для фильтрации контактов можно указать UUID группы и статус подписки.
Устарело. Эта конечная точка не позволяет указать профиль, поэтому всегда использует профиль клиента по умолчанию и не может возвращать контакты из других профилей. Вместо неё используйте GET /api/reach/v1/profiles/{profileUuid}/contacts. В новой конечной точке фильтр по группе заменён фильтром по тегу.
-
Метод:
GET -
Путь:
/api/reach/v1/contacts
reach_createANewContactV1
Создаёт новый контакт в системе email-маркетинга.
С помощью этого метода можно создать контакт и указать основные сведения: имя, адрес электронной почты и фамилию.
Если включено двойное подтверждение подписки, контакт получит статус ожидания подтверждения, а на его адрес будет отправлено письмо для подтверждения.
-
Метод:
POST -
Путь:
/api/reach/v1/contacts
reach_getContactDetailsV1
Получает полные сведения об одном контакте.
Помимо атрибутов контакта, метод возвращает назначенные ему теги и значения пользовательских полей контакта в профиле.
-
Метод:
GET -
Путь:
/api/reach/v1/profiles/{profileUuid}/contacts/{contactUuid}
reach_deleteAProfileContactV1
Безвозвратно удаляет контакт из профиля.
Вместе с контактом удаляются значения его пользовательских полей и назначенные ему теги.
-
Метод:
DELETE -
Путь:
/api/reach/v1/profiles/{profileUuid}/contacts/{contactUuid}
reach_updateAContactV1
Обновляет атрибуты контакта и значения его пользовательских полей.
Изменяются только свойства, переданные в теле запроса, поэтому для обновления одного атрибута достаточно передать только его. Если указать для свойства значение null, оно будет очищено.
В ответе возвращаются основные атрибуты контакта. Чтобы получить теги, значения пользовательских полей, источник и примечание, выполните запрос GET /api/reach/v1/profiles/{profileUuid}/contacts/{contactUuid}.
-
Метод:
PATCH -
Путь:
/api/reach/v1/profiles/{profileUuid}/contacts/{contactUuid}
reach_createContactsInBulkV1
Создаёт несколько контактов в профиле за один запрос.
Импорт выполняется в фоновом режиме, поэтому успешный ответ означает, что запрос на импорт принят, но не что импорт завершён. Контакты с адресами электронной почты, которые уже есть в профиле, не изменяются. Если включено двойное подтверждение подписки, новые контакты получают статус ожидания подтверждения, а на их адреса отправляются письма для подтверждения.
-
Метод:
POST -
Путь:
/api/reach/v1/profiles/{profileUuid}/contacts/bulk
reach_listProfileContactsV1
Возвращает постраничный список контактов профиля.
Контакты можно фильтровать по статусу подписки и тегу, а также искать по адресу электронной почты.
Поле meta.total в ответе содержит количество контактов, соответствующих фильтрам. Если не указывать фильтры, оно показывает общее количество контактов в профиле.
-
Метод:
GET -
Путь:
/api/reach/v1/profiles/{profileUuid}/contacts
reach_createNewContactsV1
Создаёт новый контакт в системе email-маркетинга.
С помощью этого метода можно создать контакт и указать основные сведения: имя, адрес электронной почты и фамилию.
Если включено двойное подтверждение подписки, контакт получит статус ожидания подтверждения, а на его адрес будет отправлено письмо для подтверждения.
-
Метод:
POST -
Путь:
/api/reach/v1/profiles/{profileUuid}/contacts
reach_listSegmentsV1
Возвращает список всех сегментов контактов.
Метод возвращает сегменты, которые можно использовать для упорядочивания контактов.
Устарел. Этот метод не позволяет указать профиль и всегда использует профиль клиента по умолчанию. Поэтому с его помощью нельзя получить список сегментов другого профиля. Вместо него используйте GET /api/reach/v1/profiles/{profileUuid}/segmentation/segments.
-
Метод:
GET -
Путь:
/api/reach/v1/segmentation/segments
reach_createANewContactSegmentV1
Создаёт новый сегмент контактов.
С помощью этого метода можно создать сегмент для упорядочивания контактов.
Для сегмента можно задать критерии, например адрес электронной почты, имя и статус подписки.
Устарел. Этот метод не позволяет указать профиль и всегда использует профиль клиента по умолчанию. Поэтому с его помощью нельзя создавать сегменты в других профилях. Вместо него используйте POST /api/reach/v1/profiles/{profileUuid}/segmentation/segments.
-
Метод:
POST -
Путь:
/api/reach/v1/segmentation/segments
reach_countProfileSegmentContactsV1
Подсчитывает количество контактов, соответствующих сегменту в данный момент, не возвращая их список.
Этот метод эффективнее постраничной загрузки контактов сегмента, если требуется только узнать их количество.
-
Метод:
GET -
Путь:
/api/reach/v1/profiles/{profileUuid}/segmentation/segments/{segmentUuid}/count
reach_listProfileSegmentContactsV1
Возвращает контакты заданного сегмента в указанном профиле.
С помощью этого метода можно получить и отфильтровать контакты, входящие в сегмент с указанным UUID в выбранном профиле.
-
Метод:
GET -
Путь:
/api/reach/v1/profiles/{profileUuid}/segmentation/segments/{segmentUuid}/contacts
reach_getProfileSegmentDetailsV1
Возвращает сведения об одном сегменте профиля, включая условия, по которым он сформирован.
Чтобы получить контакты, которые в данный момент соответствуют этим условиям, используйте метод для получения контактов сегмента.
-
Метод:
GET -
Путь:
/api/reach/v1/profiles/{profileUuid}/segmentation/segments/{segmentUuid}
reach_updateAProfileSegmentV1
Переименовывает сегмент и/или заменяет условия, по которым он сформирован.
Параметр name обязателен. Чтобы переименовать сегмент, не меняя его условия, не передавайте conditions. Если передать conditions, они полностью заменят существующий набор условий, а не дополнят его.
Контакты не изменяются, однако состав контактов, соответствующих сегменту, может измениться сразу же.
-
Метод:
PUT -
Путь:
/api/reach/v1/profiles/{profileUuid}/segmentation/segments/{segmentUuid}
reach_deleteAProfileSegmentV1
Удаляет сегмент.
Удаляется только определение сегмента. Контакты, которые ему соответствовали, остаются без изменений.
-
Метод:
DELETE -
Путь:
/api/reach/v1/profiles/{profileUuid}/segmentation/segments/{segmentUuid}
reach_listSegmentFilterAttributesV1
Возвращает список всех атрибутов, по которым можно фильтровать условия сегмента. Для каждого атрибута указаны доступные операторы, ожидаемый формат значения и, если значение ограничено, допустимые варианты.
Список зависит от профиля: он включает пользовательские поля контактов, теги и 20 недавно опубликованных кампаний этого профиля. Поэтому допустимые атрибуты нельзя задать заранее. Перед созданием или обновлением сегмента запросите этот список, чтобы определить допустимые сочетания attribute, operator и value.
-
Метод:
GET -
Путь:
/api/reach/v1/profiles/{profileUuid}/segmentation/filters/attributes
reach_previewContactsMatchingConditionsV1
Предварительно проверяет, какие контакты соответствуют заданным условиям, не сохраняя сегмент.
Тело запроса содержит тот же набор условий, что и при создании или обновлении сегмента. Используйте этот метод, чтобы до сохранения фильтра проверить, какие контакты ему соответствуют и сколько их. Данные не сохраняются, контакты не изменяются.
Сначала вызовите метод получения атрибутов фильтров сегмента, чтобы узнать допустимые сочетания attribute, operator и value.
-
Метод:
POST -
Путь:
/api/reach/v1/profiles/{profileUuid}/segmentation/filters/contacts
reach_listProfileSegmentsV1
Возвращает постраничный список сегментов, определённых в профиле.
Для каждого сегмента указывается текущее количество соответствующих ему контактов. Это число рассчитывается при чтении, а не хранится. С помощью count_type можно подсчитать либо все подходящие контакты, либо только подписанных.
-
Метод:
GET -
Путь:
/api/reach/v1/profiles/{profileUuid}/segmentation/segments
reach_createAProfileSegmentV1
Создаёт сегмент в профиле.
Сегмент хранит набор условий, а не фиксированный список контактов, поэтому его состав меняется по мере изменения контактов. Создание сегмента не изменяет контакты.
-
Метод:
POST -
Путь:
/api/reach/v1/profiles/{profileUuid}/segmentation/segments
reach_listSegmentContactsV1
Возвращает контакты, связанные с указанным сегментом.
С помощью этого метода можно получить и отфильтровать контакты, входящие в сегмент с указанным UUID.
Устарел. Этот метод не позволяет указать профиль и всегда использует профиль клиента по умолчанию. Поэтому с его помощью нельзя получить контакты сегментов других профилей. Вместо него используйте GET /api/reach/v1/profiles/{profileUuid}/segmentation/segments/{segmentUuid}/contacts.
-
Метод:
GET -
Путь:
/api/reach/v1/segmentation/segments/{segmentUuid}/contacts
reach_getSegmentDetailsV1
Возвращает сведения об указанном сегменте.
Метод получает информацию об одном сегменте по его UUID.
Сегменты позволяют упорядочивать контакты и объединять их в группы по заданным критериям.
Устарел. Этот метод не позволяет указать профиль и всегда использует профиль клиента по умолчанию. Поэтому с его помощью нельзя получить сведения о сегментах других профилей. Вместо него используйте GET /api/reach/v1/profiles/{profileUuid}/segmentation/segments/{segmentUuid}.
-
Метод:
GET -
Путь:
/api/reach/v1/segmentation/segments/{segmentUuid}
reach_assignAContactToATagV1
Назначает тег одному контакту.
В отличие от метода для массового назначения, этот метод выполняется сразу, а не ставится в очередь. Если тег уже назначен контакту, запрос завершается успешно, не создавая дубликат.
-
Метод:
POST -
Путь:
/api/reach/v1/profiles/{profileUuid}/tags/{tagUuid}/contacts/{contactUuid}
reach_removeAContactFromATagV1
Удаляет тег у одного контакта.
В отличие от пакетного метода, операция выполняется сразу, а не ставится в очередь. Сам тег и контакт
не удаляются.
-
Метод:
DELETE -
Путь:
/api/reach/v1/profiles/{profileUuid}/tags/{tagUuid}/contacts/{contactUuid}
reach_assignContactsToATagV1
Назначает тег сразу нескольким контактам.
Передайте contact_uuids, чтобы выбрать определённые контакты, или all_contacts, чтобы применить тег ко всем контактам
профиля. Операция ставится в очередь, поэтому успешный ответ означает, что запрос принят, а не
выполнен. Контакты, которым уже назначен этот тег, остаются без изменений.
-
Метод:
POST -
Путь:
/api/reach/v1/profiles/{profileUuid}/tags/{tagUuid}/contacts
reach_removeContactsFromATagV1
Удаляет тег сразу у нескольких контактов.
Передайте contact_uuids, чтобы выбрать определённые контакты, или all_contacts, чтобы применить операцию ко всем контактам
профиля. Операция ставится в очередь, поэтому успешный ответ означает, что запрос принят, а не
выполнен. Сам тег и контакты не удаляются.
-
Метод:
DELETE -
Путь:
/api/reach/v1/profiles/{profileUuid}/tags/{tagUuid}/contacts
reach_deleteATagV1
Удаляет тег и снимает его со всех контактов, которым он назначен.
Сами контакты не удаляются. Операцию можно безопасно повторять: удаление тега, которого
нет в профиле, всё равно завершается успешно.
-
Метод:
DELETE -
Путь:
/api/reach/v1/profiles/{profileUuid}/tags/{tagUuid}
reach_renameATagV1
Переименовывает тег.
Контакты, которым назначен этот тег, остаются без изменений. Названия тегов должны быть уникальными в пределах профиля, поэтому
переименование в уже занятое название будет отклонено.
-
Метод:
PATCH -
Путь:
/api/reach/v1/profiles/{profileUuid}/tags/{tagUuid}
reach_listProfileTagsV1
Возвращает все теги, созданные в профиле.
В Reach теги используются для группировки контактов. С их помощью можно фильтровать список контактов
или создавать сегменты.
-
Метод:
GET -
Путь:
/api/reach/v1/profiles/{profileUuid}/tags
reach_createOrFindTagsV1
Создаёт теги в профиле.
Если тег с таким названием уже есть в профиле, дубликат не создаётся: вместо этого возвращается существующий тег.
Поэтому запрос можно безопасно повторять. В ответе возвращаются все теги из запроса — как вновь созданные,
так и уже существовавшие.
-
Метод:
POST -
Путь:
/api/reach/v1/profiles/{profileUuid}/tags
reach_getFormDetailsV1
Возвращает форму с URL её размещённого шаблона и тегами, которые назначаются собранным контактам.
В ответе нет готового фрагмента для встраивания: разместите HTML шаблона самостоятельно
или создайте собственный вариант встраивания с использованием uuid формы.
-
Метод:
GET -
Путь:
/api/reach/v1/profiles/{profileUuid}/forms/{formUuid}
reach_deleteFormV1
Безвозвратно удаляет форму вместе с её шаблоном.
Форму, которая уже собрала отправленные данные, удалить нельзя: это гарантирует, что собранные ею контакты
не будут потеряны без предупреждения. Чтобы форма перестала собирать новые данные, приостановите её. Количество просмотров
не препятствует удалению.
-
Метод:
DELETE -
Путь:
/api/reach/v1/profiles/{profileUuid}/forms/{formUuid}
reach_listFormsV1
Возвращает постраничный список форм подписки в профиле.
Каждая форма содержит ссылку на шаблон, который её отображает. Чтобы получить непосредственно доступный URL шаблона
и список тегов, назначаемых формой собранным контактам, запросите сведения о форме.
-
Метод:
GET -
Путь:
/api/reach/v1/profiles/{profileUuid}/forms
reach_getProfileDomainDNSStatusV1
Возвращает статус DNS-настроек домена профиля.
Метод сообщает состояние записей MX, SPF, DKIM и DMARC, включая обнаруженные
записи и рекомендуемые значения, необходимые для корректной доставки электронной почты.
-
Метод:
GET -
Путь:
/api/reach/v1/profiles/{profileUuid}/domains/dns-status
reach_getConnectedSendingDomainV1
Возвращает домен отправки, подключённый к профилю, его статус проверки и адреса отправителей, действие которых приостановлено.
Кампании отправляются только при подключённом и активном домене. Поэтому этот метод позволяет быстро
проверить необходимое условие перед созданием кампании. Если домен к профилю не подключён, метод вернёт объект той же структуры, во всех полях которого указано null. Сведения об отдельных записях MX, SPF, DKIM и DMARC
можно получить с помощью метода проверки статуса DNS.
-
Метод:
GET -
Путь:
/api/reach/v1/profiles/{profileUuid}/domains
reach_listPlanFeatureAccessV1
Возвращает список возможностей тарифа, доступных профилю.
Это матрица доступности функций, а не сведения об оставшихся лимитах. Значение available означает, что функцию можно
использовать сейчас, а locked — что она не входит в базовый тариф и для её использования требуется перейти на другой тариф.
Информацию об оставшемся количестве писем, получателей и кредитов AI можно получить с помощью метода лимитов.
Метод стоит вызвать заранее, прежде чем создавать то, что впоследствии может оказаться недоступным, например
автоматизацию на тарифе, который не позволяет её активировать.
-
Метод:
GET -
Путь:
/api/reach/v1/profiles/{profileUuid}/features
reach_getRemainingPlanLimitsV1
Возвращает остаток лимитов тарифа на текущий период.
При настройке оповещений учитывайте два момента. Периодом считается календарный месяц, а не период от даты оплаты до даты оплаты, поэтому счётчики сбрасываются первого числа независимо от даты начала
подписки. Использование учитывается на уровне заказа: все профили в рамках одного заказа используют общий лимит
и получают здесь одинаковые значения. Доступны сведения только за текущий период; данные об использовании за прошлые периоды
не сохраняются.
-
Метод:
GET -
Путь:
/api/reach/v1/profiles/{profileUuid}/limits
reach_listProfilesV1
Возвращает все профили, доступные клиенту, включая основную информацию о них.
-
Метод:
GET -
Путь:
/api/reach/v1/profiles
reach_listEmailTemplatesV1
Возвращает список шаблонов электронных писем в профиле, начиная с недавно обновлённых.
Шаблоны — это повторно используемые тексты писем, на основе которых создаются кампании. Список не разбит на страницы,
а в ответе возвращаются только метаданные — содержимое шаблонов недоступно. Используйте uuid шаблона как template_uuid при создании кампании.
-
Метод:
GET -
Путь:
/api/reach/v1/profiles/{profileUuid}/templates
reach_createAnEmailTemplateV1
Создаёт шаблон электронного письма в профиле.
Шаблон содержит HTML-код письма, который повторно используется в кампаниях, поэтому его можно создать ещё до создания
кампании. В ответе возвращаются только метаданные шаблона. Сохраните полученный uuid, чтобы указать его в поле template_uuid кампании.
-
Метод:
POST -
Путь:
/api/reach/v1/profiles/{profileUuid}/templates
hostinger-vps-mcp
VPS_getDataCenterListV1
Возвращает список всех доступных дата-центров.
Используйте этот метод, чтобы ознакомиться с вариантами размещения перед развёртыванием VPS.
-
Метод:
GET -
Путь:
/api/vps/v1/data-centers
VPS_getProjectContainersV1
Возвращает список всех контейнеров, принадлежащих определённому проекту Docker Compose на виртуальной машине.
Для каждого контейнера метод возвращает подробную информацию, включая
текущий статус, сопоставления портов и конфигурацию во время выполнения.
Используйте его, чтобы отслеживать состояние и работу всех служб в проекте Docker Compose.
-
Метод:
GET -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/docker/{projectName}/containers
VPS_getProjectContentsV1
Возвращает полную информацию о проекте: содержимое файла docker-compose.yml,
метаданные проекта и текущий статус развёртывания.
Метод предоставляет полные сведения о конфигурации и состоянии определённого проекта Docker Compose.
Используйте его, чтобы проверить настройки проекта, просмотреть compose-файл или оценить общее состояние проекта.
-
Метод:
GET -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/docker/{projectName}
VPS_deleteProjectV1
Полностью удаляет проект Docker Compose с виртуальной машины, останавливает все контейнеры и очищает
связанные ресурсы, включая сети, тома и образы.
Операция необратима и приводит к удалению всех данных проекта.
Используйте её, чтобы окончательно удалить проект и освободить системные ресурсы.
-
Метод:
DELETE -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/docker/{projectName}/down
VPS_getProjectListV1
Возвращает список всех проектов Docker Compose, развёрнутых на виртуальной машине.
Для каждого проекта метод возвращает основную информацию, включая название,
статус, путь к файлу и список контейнеров с данными об их названиях,
образах, статусе, состоянии работоспособности и портах. Статистика контейнеров в этом ответе не приводится.
Чтобы получить подробные сведения о контейнере, включая статистику, используйте метод Get project containers.
Используйте этот метод, чтобы просмотреть все проекты Docker на вашем экземпляре VPS.
-
Метод:
GET -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/docker
VPS_createNewProjectV1
Разворачивает новый проект из содержимого docker-compose.yaml или загружает его по URL.
URL может вести на репозиторий Github в формате https://github.com/[user]/[repo].
В этом случае файл docker-compose.yaml будет автоматически найден в ветке master. Любой другой указанный URL должен возвращать содержимое файла docker-compose.yaml.
Если проект с таким именем уже существует, он будет заменён.
-
Метод:
POST -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/docker
VPS_getProjectLogsV1
Получает объединённые записи журналов всех сервисов проекта Docker Compose.
Метод возвращает последние записи журналов каждого контейнера, сгруппированные по имени сервиса и снабжённые временными метками.
Ответ содержит до 300 последних записей журналов всех сервисов.
Используйте этот метод для отладки, мониторинга работы приложения и устранения неполадок во всём стеке проекта.
-
Метод:
GET -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/docker/{projectName}/logs
VPS_restartProjectV1
Перезапускает все сервисы проекта Docker Compose: останавливает и запускает контейнеры в правильном порядке с учётом зависимостей.
Операция сохраняет тома данных и сетевые настройки, обновляя при этом работающие контейнеры.
Используйте этот метод, чтобы применить изменения конфигурации или восстановить работу после сбоев сервисов.
-
Метод:
POST -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/docker/{projectName}/restart
VPS_startProjectV1
Запускает все остановленные сервисы проекта Docker Compose.
Контейнеры запускаются в правильном порядке с учётом зависимостей, указанных в файле compose.
Используйте этот метод, чтобы возобновить работу остановленного проекта или запустить сервисы после перезагрузки системы.
-
Метод:
POST -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/docker/{projectName}/start
VPS_stopProjectV1
Останавливает все работающие сервисы проекта Docker Compose, сохраняя конфигурации контейнеров и тома данных.
Контейнеры корректно завершают работу в обратном порядке с учётом зависимостей.
Используйте этот метод, чтобы временно остановить проект, не удаляя данные и конфигурации.
-
Метод:
POST -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/docker/{projectName}/stop
VPS_updateProjectV1
Обновляет проект Docker Compose: загружает последние версии образов и пересоздаёт контейнеры с новыми конфигурациями.
Операция сохраняет тома данных и применяет изменения из файла compose.
Используйте этот метод для развёртывания обновлений приложения, изменения конфигурации или обновления образов контейнеров до последних версий.
-
Метод:
POST -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/docker/{projectName}/update
VPS_activateFirewallV1
Включает firewall для указанной виртуальной машины.
Для виртуальной машины может быть активен только один firewall одновременно.
Используйте этот метод, чтобы применить правила firewall к экземплярам VPS.
-
Метод:
POST -
Путь:
/api/vps/v1/firewall/{firewallId}/activate/{virtualMachineId}
VPS_deactivateFirewallV1
Отключает firewall для указанной виртуальной машины.
Используйте этот метод, чтобы снять защиту firewall с экземпляров VPS.
-
Метод:
POST -
Путь:
/api/vps/v1/firewall/{firewallId}/deactivate/{virtualMachineId}
VPS_getFirewallDetailsV1
Получает firewall по его ID и связанные с ним правила.
Используйте этот метод, чтобы просмотреть настройки и правила конкретного firewall.
-
Метод:
GET -
Путь:
/api/vps/v1/firewall/{firewallId}
VPS_deleteFirewallV1
Удаляет указанный firewall.
Если этот firewall активен на виртуальных машинах, он будет автоматически отключён на них.
Используйте этот метод, чтобы удалить неиспользуемые конфигурации firewall.
-
Метод:
DELETE -
Путь:
/api/vps/v1/firewall/{firewallId}
VPS_getFirewallListV1
Получает список всех доступных firewall.
Используйте этот метод, чтобы просмотреть существующие конфигурации firewall.
-
Метод:
GET -
Путь:
/api/vps/v1/firewall
VPS_createNewFirewallV1
Создаёт новый firewall.
Используйте этот метод, чтобы настроить firewall для защиты VPS.
-
Метод:
POST -
Путь:
/api/vps/v1/firewall
VPS_updateFirewallRuleV1
Изменяет указанное правило firewall.
Виртуальные машины с активированным firewall потеряют синхронизацию с ним. После этого синхронизацию потребуется выполнить вручную.
Используйте этот метод, чтобы изменить существующие правила firewall.
-
Метод:
PUT -
Путь:
/api/vps/v1/firewall/{firewallId}/rules/{ruleId}
VPS_deleteFirewallRuleV1
Удаляет указанное правило из firewall.
Виртуальные машины с активированным firewall потеряют синхронизацию с ним. После этого синхронизацию потребуется выполнить вручную.
Используйте этот метод, чтобы удалить отдельные правила firewall.
-
Метод:
DELETE -
Путь:
/api/vps/v1/firewall/{firewallId}/rules/{ruleId}
VPS_replaceAllFirewallRulesInGroupV1
Атомарно заменяет все правила в указанной группе firewall предоставленным набором, избавляя от необходимости добавлять или удалять правила по одному.
После замены правил потребуется синхронизировать все виртуальные машины, использующие эту группу firewall. Чтобы запустить синхронизацию сразу, передайте параметр "sync".
-
Метод:
PUT -
Путь:
/api/vps/v1/firewall/{firewallId}/rules
VPS_createFirewallRuleV1
Создаёт новое правило для указанного firewall.
По умолчанию firewall блокирует весь входящий трафик. Поэтому необходимо добавить правила разрешения для всех портов, которые вы хотите использовать.
Виртуальные машины с активированным firewall потеряют синхронизацию с ним. После этого синхронизацию потребуется выполнить вручную.
Используйте этот метод, чтобы добавить в firewall новые правила безопасности.
-
Метод:
POST -
Путь:
/api/vps/v1/firewall/{firewallId}/rules
VPS_syncFirewallToAllAssignedVMsV1
Синхронизирует правила firewall со всеми назначенными ему виртуальными машинами.
Синхронизация firewall с виртуальной машиной может быть нарушена после добавления, удаления или изменения правил.
Используйте этот метод, чтобы применить обновлённые правила firewall ко всем назначенным ему экземплярам VPS.
-
Метод:
POST -
Путь:
/api/vps/v1/firewall/{firewallId}/sync
VPS_syncFirewallV1
Устаревший метод: вместо него используйте POST /api/vps/v1/firewall/{firewallId}/sync. Он синхронизирует firewall со всеми назначенными ему виртуальными машинами.
Синхронизирует firewall с указанной виртуальной машиной.
Синхронизация firewall с виртуальной машиной может быть нарушена после добавления, удаления или изменения правил.
Используйте этот метод, чтобы применить обновлённые правила firewall к экземплярам VPS.
-
Метод:
POST -
Путь:
/api/vps/v1/firewall/{firewallId}/sync/{virtualMachineId}
VPS_getPostInstallScriptV1
Получает скрипт после установки по его ID.
Используйте этот метод, чтобы просмотреть сведения о конкретном скрипте автоматизации.
-
Метод:
GET -
Путь:
/api/vps/v1/post-install-scripts/{postInstallScriptId}
VPS_updatePostInstallScriptV1
Изменяет указанный скрипт после установки.
Используйте этот метод, чтобы отредактировать существующие скрипты автоматизации.
-
Метод:
PUT -
Путь:
/api/vps/v1/post-install-scripts/{postInstallScriptId}
VPS_deletePostInstallScriptV1
Удаляет скрипт после установки из вашей учётной записи.
Используйте этот метод, чтобы удалить неиспользуемые скрипты автоматизации.
-
Метод:
DELETE -
Путь:
/api/vps/v1/post-install-scripts/{postInstallScriptId}
VPS_getPostInstallScriptsV1
Получает скрипты после установки, связанные с вашей учётной записью.
Используйте этот метод, чтобы просмотреть доступные скрипты автоматизации для развёртывания VPS.
-
Метод:
GET -
Путь:
/api/vps/v1/post-install-scripts
VPS_createPostInstallScriptV1
Добавляет в вашу учётную запись скрипт после установки, который можно запускать после установки виртуальной машины.
Содержимое скрипта сохраняется в файл /post_install с атрибутом, разрешающим выполнение. Скрипт запускается один раз после установки виртуальной машины.
Вывод скрипта перенаправляется в /post_install.log. Максимальный размер скрипта — 48KB.
Используйте этот метод для создания скриптов автоматизации настройки VPS.
-
Метод:
POST -
Путь:
/api/vps/v1/post-install-scripts
VPS_attachPublicKeyV1
Добавляет к указанной виртуальной машине существующие публичные ключи из вашей учётной записи.
К одной виртуальной машине можно добавить несколько ключей.
Используйте этот метод, чтобы включить аутентификацию по SSH-ключу для экземпляров VPS.
-
Метод:
POST -
Путь:
/api/vps/v1/public-keys/attach/{virtualMachineId}
VPS_deletePublicKeyV1
Удаляет публичный ключ из вашей учётной записи.
Удаление публичного ключа из учётной записи не удаляет его с виртуальной машины
Используйте этот метод, чтобы удалить неиспользуемые SSH-ключи из учётной записи.
-
Метод:
DELETE -
Путь:
/api/vps/v1/public-keys/{publicKeyId}
VPS_getPublicKeysV1
Получить публичные ключи, связанные с вашей учётной записью.
Используйте эту конечную точку, чтобы просмотреть SSH-ключи, доступные для аутентификации VPS.
-
Метод:
GET -
Путь:
/api/vps/v1/public-keys
VPS_createPublicKeyV1
Добавить новый публичный ключ в учётную запись.
Используйте эту конечную точку, чтобы зарегистрировать SSH-ключ для аутентификации VPS.
-
Метод:
POST -
Путь:
/api/vps/v1/public-keys
VPS_getTemplateDetailsV1
Получить подробную информацию о шаблоне ОС для виртуальной машины.
Используйте эту конечную точку, чтобы изучить характеристики шаблона перед развертыванием.
-
Метод:
GET -
Путь:
/api/vps/v1/templates/{templateId}
VPS_getTemplatesV1
Получить список доступных шаблонов ОС для виртуальных машин.
Используйте эту конечную точку, чтобы ознакомиться с вариантами операционных систем перед созданием или повторным созданием экземпляра VPS.
-
Метод:
GET -
Путь:
/api/vps/v1/templates
VPS_getActionDetailsV1
Получить подробную информацию о действии, выполненном на указанной виртуальной машине.
Используйте эту конечную точку, чтобы отслеживать состояние и подробности конкретной операции VPS.
-
Метод:
GET -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/actions/{actionId}
VPS_getActionsV1
Получить список действий, выполненных на указанной виртуальной машине.
К действиям относятся операции и события, например запуск, остановка или изменение виртуальной машины. Эта конечная точка позволяет просматривать историю действий и сведения о каждом из них: название, дату и время, а также статус.
Используйте эту конечную точку, чтобы изучить историю операций VPS и устранить неполадки.
-
Метод:
GET -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/actions
VPS_getAttachedPublicKeysV1
Получить публичные ключи, подключённые к указанной виртуальной машине.
Используйте эту конечную точку, чтобы просмотреть SSH-ключи, настроенные для конкретных экземпляров VPS.
-
Метод:
GET -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/public-keys
VPS_getBackupsV1
Получить список резервных копий указанной виртуальной машины.
Используйте эту конечную точку, чтобы просмотреть доступные точки восстановления данных VPS.
-
Метод:
GET -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/backups
VPS_restoreBackupV1
Восстановить резервную копию указанной виртуальной машины.
Система запустит процесс восстановления. Его продолжительность зависит от размера резервной копии.
Все данные на виртуальной машине будут заменены данными из резервной копии.
Используйте эту конечную точку, чтобы восстановить данные VPS из резервной копии.
-
Метод:
POST -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/backups/{backupId}/restore
VPS_setHostnameV1
Задать имя хоста для указанной виртуальной машины.
При смене имени хоста PTR-запись не обновляется автоматически.
Чтобы виртуальную машину можно было найти по имени хоста, также необходимо направить на её IP-адрес записи A/AAAA домена.
Используйте эту конечную точку, чтобы задать собственные имена хостов для экземпляров VPS.
-
Метод:
PUT -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/hostname
VPS_resetHostnameV1
Вернуть имя хоста и PTR-запись указанной виртуальной машины к значениям по умолчанию.
Используйте эту конечную точку, чтобы восстановить стандартные настройки имени хоста для экземпляров VPS.
-
Метод:
DELETE -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/hostname
VPS_getVirtualMachineDetailsV1
Получить подробную информацию об указанной виртуальной машине.
Используйте эту конечную точку, чтобы просмотреть полную конфигурацию и состояние VPS.
-
Метод:
GET -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}
VPS_getVirtualMachinesV1
Получить список всех доступных виртуальных машин.
Используйте эту конечную точку, чтобы просмотреть доступные экземпляры VPS.
-
Метод:
GET -
Путь:
/api/vps/v1/virtual-machines
VPS_purchaseNewVirtualMachineV1
Приобрести и настроить новую виртуальную машину.
Если настроить виртуальную машину не удастся, войдите в hPanel и завершите настройку вручную.
Если способ оплаты не указан, система автоматически использует способ оплаты по умолчанию.
Если ответ имеет статус 202 Accepted, обработка платежа ещё не завершена, и виртуальная машина не настроена. Войдите в hPanel и завершите настройку вручную.
Используйте эту конечную точку, чтобы создать новые экземпляры VPS.
-
Метод:
POST -
Путь:
/api/vps/v1/virtual-machines
VPS_getScanMetricsV1
Получить показатели сканирования, выполненного сканером вредоносных программ Monarx, установленным на указанной виртуальной машине.
Показатели содержат подробные сведения о проверках Monarx: количество сканирований, обнаруженные угрозы и другую статистику. Эти данные помогают отслеживать состояние безопасности виртуальной машины и оценивать эффективность сканера.
Используйте эту конечную точку, чтобы отслеживать результаты проверок безопасности VPS и обнаруженные угрозы.
-
Метод:
GET -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/monarx
VPS_installMonarxV1
Установить сканер вредоносных программ Monarx на указанную виртуальную машину.
Monarx — инструмент безопасности, предназначенный для обнаружения и предотвращения заражения виртуальных машин вредоносными программами. Установка Monarx повышает защищённость виртуальной машины от вредоносного ПО.
Используйте эту конечную точку, чтобы включить защиту от вредоносных программ на экземплярах VPS.
-
Метод:
POST -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/monarx
VPS_uninstallMonarxV1
Удалить сканер вредоносных программ Monarx с указанной виртуальной машины.
Если Monarx не установлен, запрос всё равно будет обработан, но ничего не изменится.
Используйте эту конечную точку, чтобы удалить сканер вредоносных программ с экземпляров VPS.
-
Метод:
DELETE -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/monarx
VPS_getMetricsV1
Получить исторические показатели указанной виртуальной машины.
Включены следующие показатели:
-
Использование CPU
-
Использование памяти
-
Использование диска
-
Использование сети
-
Время непрерывной работы
Используйте эту конечную точку, чтобы отслеживать производительность VPS и использование ресурсов в динамике.
-
Метод:
GET -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/metrics
VPS_setNameserversV1
Задать серверы имён для указанной виртуальной машины.
Неправильная настройка серверов имён может привести к тому, что виртуальная машина не сможет разрешать доменные имена.
Используйте эту конечную точку, чтобы настроить собственные DNS-резолверы для экземпляров VPS.
-
Метод:
PUT -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/nameservers
VPS_createPTRRecordV1
Создать или обновить PTR-запись (Pointer) для указанной виртуальной машины.
Используйте эту конечную точку, чтобы настроить обратное разрешение DNS для IP-адресов VPS.
-
Метод:
POST -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/ptr/{ipAddressId}
VPS_deletePTRRecordV1
Удалить PTR-запись (Pointer) для указанной виртуальной машины.
После удаления при обратном DNS-запросе к IP-адресу виртуальной машины ранее заданное имя хоста возвращаться не будет.
Используйте эту конечную точку, чтобы удалить настройки обратного DNS для экземпляров VPS.
-
Метод:
DELETE -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/ptr/{ipAddressId}
VPS_setPanelPasswordV1
Задать пароль панели управления для указанной виртуальной машины.
Если на виртуальной машине не установлена ОС с панелью управления, запрос всё равно будет обработан, но ничего не изменится.
Требования к паролю совпадают с требованиями для конечной точки повторного создания виртуальной машины.
Используйте эту конечную точку, чтобы настроить учётные данные для доступа к панели управления экземплярами VPS.
-
Метод:
PUT -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/panel-password
VPS_startRecoveryModeV1
Запустить режим восстановления для указанной виртуальной машины.
Режим восстановления позволяет выполнять аварийное обслуживание системы: восстанавливать файловые системы и данные, а также устранять неполадки, из-за которых виртуальная машина не может нормально загрузиться.
Виртуальная машина загрузится с образа диска восстановления, а исходный образ диска будет смонтирован в каталоге /mnt.
Используйте эту конечную точку, чтобы запустить аварийное обслуживание экземпляров VPS.
-
Метод:
POST -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/recovery
VPS_stopRecoveryModeV1
Остановить режим восстановления для указанной виртуальной машины.
Если виртуальная машина не находится в режиме восстановления, операция завершится ошибкой.
Используйте эту конечную точку, чтобы выйти из режима восстановления и вернуть VPS к обычной работе.
-
Метод:
DELETE -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/recovery
VPS_recreateVirtualMachineV1
Создать виртуальную машину заново.
В ходе переустановки операционная система будет установлена повторно, а виртуальная машина вернётся к исходному состоянию.
Все имеющиеся снимки будут удалены.
Требования к паролю
Пароль будет проверен по базам данных скомпрометированных паролей.
Пароль должен соответствовать следующим требованиям:
-
Содержать не менее 12 символов
-
Содержать хотя бы одну заглавную букву
-
Содержать хотя бы одну строчную букву
-
Содержать хотя бы одну цифру
-
Не быть опубликованным в открытом доступе
Это действие необратимо и приведёт к потере всех данных, хранящихся на виртуальной машине!
Используйте эту конечную точку, чтобы полностью пересоздать экземпляр VPS и установить на него новую операционную систему.
-
Метод:
POST -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/recreate
VPS_restartVirtualMachineV1
Перезапустить указанную виртуальную машину: полностью остановить её, а затем запустить снова.
Если виртуальная машина была остановлена, она будет запущена.
Используйте эту конечную точку для перезагрузки экземпляров VPS.
-
Метод:
POST -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/restart
VPS_setRootPasswordV1
Задать пароль root для указанной виртуальной машины.
Пароль должен соответствовать тем же требованиям, что и в конечной точке пересоздания виртуальной машины.
Используйте эту конечную точку, чтобы обновить учётные данные администратора экземпляра VPS.
-
Метод:
PUT -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/root-password
VPS_setupPurchasedVirtualMachineV1
Настроить новую приобретённую виртуальную машину, находящуюся в состоянии initial.
Используйте эту конечную точку для настройки и инициализации приобретённых экземпляров VPS.
-
Метод:
POST -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/setup
VPS_getSnapshotV1
Получить снимок указанной виртуальной машины.
Используйте эту конечную точку, чтобы просмотреть сведения о текущем снимке VPS.
-
Метод:
GET -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/snapshot
VPS_createSnapshotV1
Создать снимок указанной виртуальной машины.
Снимок сохраняет состояние и данные виртуальной машины на определённый момент времени. При необходимости его можно использовать для восстановления этого состояния.
Снимки полезны для резервного копирования, восстановления системы и проверки изменений без воздействия на текущее состояние виртуальной машины.
При создании нового снимка существующий снимок будет перезаписан!
Используйте эту конечную точку, чтобы сохранить состояние VPS для последующего резервного копирования или восстановления.
-
Метод:
POST -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/snapshot
VPS_deleteSnapshotV1
Удалить снимок указанной виртуальной машины.
Используйте эту конечную точку, чтобы удалить снимок VPS.
-
Метод:
DELETE -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/snapshot
VPS_restoreSnapshotV1
Восстановить предыдущее состояние указанной виртуальной машины из снимка.
Восстановление из снимка возвращает виртуальную машину к сохранённому состоянию. Это полезно для восстановления системы, отмены изменений или тестирования.
Используйте эту конечную точку, чтобы вернуть экземпляр VPS к одному из сохранённых состояний.
-
Метод:
POST -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/snapshot/restore
VPS_startVirtualMachineV1
Запустить указанную виртуальную машину.
Если виртуальная машина уже работает, запрос всё равно будет обработан, но состояние не изменится.
Используйте эту конечную точку, чтобы включить остановленный экземпляр VPS.
-
Метод:
POST -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/start
VPS_stopVirtualMachineV1
Остановить указанную виртуальную машину.
Если виртуальная машина уже остановлена, запрос всё равно будет обработан, но состояние не изменится.
Это действие меняет только состояние вычислительных ресурсов и не влияет на оплату. Чтобы прекратить дальнейшее списание средств, отключите автоматическое продление подписки, к которой привязана виртуальная машина.
Используйте эту конечную точку, чтобы выключить работающий экземпляр VPS.
-
Метод:
POST -
Путь:
/api/vps/v1/virtual-machines/{virtualMachineId}/stop
hostinger-wordpress-mcp
hosting_showAIOptionStatusV1
Получить текущее состояние параметров AI плагина Hostinger Tools для указанной установки WordPress. Укажите option, чтобы получить сведения об одном параметре, или не указывайте его, чтобы получить все параметры.
Укажите в пути идентификатор установки WordPress (software). Его можно получить с помощью GET /api/hosting/v1/wordpress/installations: это поле id.
-
Метод:
GET -
Путь:
/api/hosting/v1/accounts/{username}/wordpress/{software}/hostinger-plugins/ai-option/status
hosting_setAIOptionStatusV1
Включить или отключить параметр AI плагина Hostinger Tools для указанной установки WordPress.
Укажите в пути идентификатор установки WordPress (software). Его можно получить с помощью GET /api/hosting/v1/wordpress/installations: это поле id.
-
Метод:
PATCH -
Путь:
/api/hosting/v1/accounts/{username}/wordpress/{software}/hostinger-plugins/ai-option/status
hosting_checkIfWordPressInstallationsAreValidV1
Проверить работоспособность одной или нескольких установок WordPress. Конечная точка выявляет неисправности, вызванные отсутствующими файлами, проблемами с плагинами, темами и другими подобными причинами.
Передайте в теле запроса идентификаторы установок WordPress (software). Их можно получить с помощью GET /api/hosting/v1/wordpress/installations: это поле id.
-
Метод:
POST -
Путь:
/api/hosting/v1/accounts/{username}/wordpress/installations/check-is-valid
hosting_deleteWordPressInstallationV1
Удалить указанную установку WordPress, при необходимости удалив связанные файлы и базу данных. Будут удалены все связанные компоненты, включая плагины, темы, тестовые сайты и другие данные.
Укажите в пути идентификатор установки WordPress (software). Его можно получить с помощью GET /api/hosting/v1/wordpress/installations: это поле id.
-
Метод:
DELETE -
Путь:
/api/hosting/v1/accounts/{username}/wordpress/{software}
hosting_detectWordPressInstallationsV1
Запустить фоновое сканирование для поиска установок WordPress в аккаунте.
Операция выполняется асинхронно: успешный ответ означает лишь то, что сканирование поставлено в очередь. После его завершения опросите GET /api/hosting/v1/wordpress/installations, чтобы получить список найденных установок.
-
Метод:
POST -
Путь:
/api/hosting/v1/accounts/{username}/wordpress/installations/detect
hosting_importWordPressWebsiteV1
Импортировать сайт WordPress в указанный домен.
ВНИМАНИЕ: существующее содержимое сайта будет перезаписано без возможности отмены. Перед вызовом этой конечной точки убедитесь, что это действие необходимо.
Эта конечная точка позволяет импортировать сайт WordPress из файлов архива и базы данных, загруженных в каталог сайта.
-
Метод:
POST -
Путь:
/api/hosting/v1/accounts/{username}/websites/{domain}/wordpress/import
hosting_installWordPressV1
Установить WordPress на существующий сайт.
Перед вызовом этой конечной точки сайт должен быть создан. Чтобы сначала создать сайт, используйте POST /api/hosting/v1/websites и опрашивайте GET /api/hosting/v1/websites, пока сайт не появится в списке.
Перед установкой выполните GET /api/hosting/v1/wordpress/installations с фильтрами по имени пользователя и домену, чтобы проверить, установлен ли WordPress по указанному домену или пути. Если WordPress уже установлен, а параметр overwrite не задан или равен false (значение по умолчанию), асинхронная задача завершится ошибкой.
Операция выполняется асинхронно: успешный ответ означает лишь, что задача установки поставлена в очередь, а не то, что WordPress уже готов. Установка обычно занимает 1–2 минуты. Отслеживайте её ход, опрашивая GET /api/hosting/v1/wordpress/installations с фильтрами по имени пользователя и домену. WordPress будет готов, когда установка появится в списке.
-
Метод:
POST -
Путь:
/api/hosting/v1/accounts/{username}/wordpress/installations
hosting_listWordPressInstallationsV1
Получить список установок WordPress, доступных аутентифицированному клиенту.
Используйте эту конечную точку, чтобы найти существующие установки WordPress и проверить состояние установки после вызова конечной точки установки. Когда запрошенная установка появится в списке, WordPress будет готов. Чтобы сузить результаты до конкретного сайта, укажите фильтры по имени пользователя и домену.
Для каждой установки возвращается флаг valid; если установка недействительна, также указывается поле validationError с описанием причины.
-
Метод:
GET -
Путь:
/api/hosting/v1/wordpress/installations
hosting_listAvailableWordPressCoreUpdatesV1
Получить список доступных обновлений ядра WordPress для указанной установки.
Укажите в пути идентификатор установки WordPress (software). Его можно получить с помощью GET /api/hosting/v1/wordpress/installations: это поле id.
-
Метод:
GET -
Путь:
/api/hosting/v1/accounts/{username}/wordpress/{software}/updates
hosting_getInstallationJWTTokenV1
Возвращает JWT-токен для аутентификации запросов к указанной установке
WordPress, включая её конечную точку MCP (Model Context Protocol).
Укажите в пути идентификатор установки WordPress (software). Его можно
получить из GET /api/hosting/v1/wordpress/installations (поле id).
-
Method:
GET -
Path:
/api/hosting/v1/accounts/{username}/wordpress/{software}/jwt-token
hosting_showWordPressCoreVersionV1
Возвращает версию ядра WordPress для указанной установки, а также сведения
об известных уязвимостях, которые её затрагивают.
Укажите в пути идентификатор установки WordPress (software). Его можно
получить из GET /api/hosting/v1/wordpress/installations (поле id).
-
Method:
GET -
Path:
/api/hosting/v1/accounts/{username}/wordpress/{software}/version
hosting_updateWordPressCoreV1
Обновляет ядро WordPress для указанной установки: выполняет минорное
обновление или устанавливает выбранную версию.
Укажите в пути идентификатор установки WordPress (software). Его можно
получить из GET /api/hosting/v1/wordpress/installations (поле id).
Операция выполняется асинхронно: успешный ответ означает только то, что
задание на обновление поставлено в очередь.
-
Method:
POST -
Path:
/api/hosting/v1/accounts/{username}/wordpress/{software}/update
hosting_purgeLiteSpeedCacheV1
Очищает LiteSpeed Cache для указанной установки WordPress.
Укажите в пути идентификатор установки WordPress (software). Его можно
получить из GET /api/hosting/v1/wordpress/installations (поле id).
-
Method:
POST -
Path:
/api/hosting/v1/accounts/{username}/wordpress/{software}/litespeed-cache/purge
hosting_showLiteSpeedCacheStatusV1
Возвращает статус LiteSpeed Cache для указанной установки WordPress.
Укажите в пути идентификатор установки WordPress (software). Его можно
получить из GET /api/hosting/v1/wordpress/installations (поле id).
-
Method:
GET -
Path:
/api/hosting/v1/accounts/{username}/wordpress/{software}/litespeed-cache/status
hosting_createLoginLinksV1
Создаёт временные ссылки для автоматического входа в указанную установку
WordPress.
Укажите в пути идентификатор установки WordPress (software). Его можно
получить из GET /api/hosting/v1/wordpress/installations (поле id).
-
Method:
POST -
Path:
/api/hosting/v1/accounts/{username}/wordpress/{software}/login/links
hosting_showMaintenanceStatusV1
Возвращает статус режима обслуживания для указанной установки WordPress.
Укажите в пути идентификатор установки WordPress (software). Его можно
получить из GET /api/hosting/v1/wordpress/installations (поле id).
-
Method:
GET -
Path:
/api/hosting/v1/accounts/{username}/wordpress/{software}/maintenance/status
hosting_toggleMaintenanceModeV1
Включает или отключает режим обслуживания для указанной установки WordPress
в зависимости от значения флага enabled.
Укажите в пути идентификатор установки WordPress (software). Его можно
получить из GET /api/hosting/v1/wordpress/installations (поле id).
-
Method:
PATCH -
Path:
/api/hosting/v1/accounts/{username}/wordpress/{software}/maintenance/toggle
hosting_showMemcachedObjectCacheStatusV1
Возвращает статус объектного кэша Memcached для указанной установки
WordPress.
Укажите в пути идентификатор установки WordPress (software). Его можно
получить из GET /api/hosting/v1/wordpress/installations (поле id).
-
Method:
GET -
Path:
/api/hosting/v1/accounts/{username}/wordpress/{software}/memcached/status
hosting_toggleMemcachedObjectCacheV1
Включает или отключает объектный кэш Memcached для указанной установки
WordPress в зависимости от значения флага enabled.
Укажите в пути идентификатор установки WordPress (software). Его можно
получить из GET /api/hosting/v1/wordpress/installations (поле id).
-
Method:
PATCH -
Path:
/api/hosting/v1/accounts/{username}/wordpress/{software}/memcached/toggle
hosting_activateWordPressPluginV1
Активирует установленный плагин в WordPress.
Укажите в пути идентификатор установки WordPress (software). Его можно
получить из GET /api/hosting/v1/wordpress/installations (поле id).
Операция выполняется асинхронно: успешный ответ означает только то, что
задание на активацию поставлено в очередь.
-
Method:
POST -
Path:
/api/hosting/v1/accounts/{username}/wordpress/{software}/plugins/activate
hosting_deactivateWordPressPluginV1
Деактивирует установленный плагин в WordPress.
Укажите в пути идентификатор установки WordPress (software). Его можно
получить из GET /api/hosting/v1/wordpress/installations (поле id).
Операция выполняется асинхронно: успешный ответ означает только то, что
задание на деактивацию поставлено в очередь.
-
Method:
POST -
Path:
/api/hosting/v1/accounts/{username}/wordpress/{software}/plugins/deactivate
hosting_deployWordPressPluginV1
Развёртывает плагин WordPress из уже загруженной директории.
Эта конечная точка позволяет развернуть плагин WordPress, загруженный в
директорию сайта.
Плагин будет активирован и станет доступен в панели администратора WordPress.
-
Method:
POST -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/wordpress/plugins/deploy
hosting_installWordPressPluginsV1
Устанавливает один или несколько плагинов в существующую установку WordPress.
Укажите в пути идентификатор установки WordPress (software). Его можно
получить из GET /api/hosting/v1/wordpress/installations (поле id).
Чтобы узнать доступные для установки плагины, используйте GET
/api/hosting/v1/wordpress/plugins.
Операция выполняется асинхронно: успешный ответ означает только то, что
задание на установку поставлено в очередь, но не подтверждает готовность плагинов.
-
Method:
POST -
Path:
/api/hosting/v1/accounts/{username}/wordpress/{software}/plugins/install
hosting_listAvailableWordPressPluginsV1
Возвращает список рекомендованных для установки плагинов, которые ещё не
установлены в WordPress.
Укажите в пути идентификатор установки WordPress (software). Его можно
получить из GET /api/hosting/v1/wordpress/installations (поле id).
-
Method:
GET -
Path:
/api/hosting/v1/accounts/{username}/wordpress/{software}/plugins/available
hosting_listInstalledWordPressPluginsV1
Возвращает список плагинов, установленных в WordPress, с указанием их
статуса, доступных обновлений и известных уязвимостей.
Укажите в пути идентификатор установки WordPress (software). Его можно
получить из GET /api/hosting/v1/wordpress/installations (поле id).
-
Method:
GET -
Path:
/api/hosting/v1/accounts/{username}/wordpress/{software}/plugins
hosting_searchWordPressPluginsV1
Ищет плагины, доступные для установки, в каталоге WordPress.org.
Используйте полученные значения slug при вызове
POST /api/hosting/v1/accounts/{username}/wordpress/{software}/plugins/install.
-
Method:
GET -
Path:
/api/hosting/v1/wordpress/plugins
hosting_listSuggestedWordPressPluginsV1
Возвращает подборки рекомендованных плагинов, сгруппированных по типам сайтов.
Используйте полученные значения slug при вызове
POST /api/hosting/v1/accounts/{username}/wordpress/{software}/plugins/install.
-
Method:
GET -
Path:
/api/hosting/v1/wordpress/plugins/suggested
hosting_checkIfWooCommerceIsInstalledV1
Проверяет, установлен ли WooCommerce хотя бы в одной установке WordPress,
связанной с доменом. При необходимости проверку можно ограничить указанным доменом.
-
Method:
GET -
Path:
/api/hosting/v1/wordpress/plugins/is-woocommerce-installed
hosting_uninstallWordPressPluginsV1
Удаляет один или несколько плагинов из установки WordPress.
Укажите в пути идентификатор установки WordPress (software). Его можно
получить из GET /api/hosting/v1/wordpress/installations (поле id).
Операция выполняется асинхронно: успешный ответ означает только то, что
задание на удаление поставлено в очередь.
-
Method:
POST -
Path:
/api/hosting/v1/accounts/{username}/wordpress/{software}/plugins/uninstall
hosting_updateHostingerWordPressPluginV1
Обновляет плагин Hostinger до последней версии в установке WordPress.
Укажите в пути идентификатор установки WordPress (software). Его можно
получить из GET /api/hosting/v1/wordpress/installations (поле id).
Операция выполняется асинхронно: успешный ответ означает только то, что
задание на обновление поставлено в очередь.
-
Method:
POST -
Path:
/api/hosting/v1/accounts/{username}/wordpress/{software}/plugins/hostinger/update
hosting_updateWordPressPluginsV1
Обновить один или несколько установленных плагинов до последних версий в установленном WordPress.
Укажите в пути идентификатор установки WordPress (software). Его можно получить из GET /api/hosting/v1/wordpress/installations (поле id).
Операция выполняется асинхронно: успешный ответ означает только то, что задание на обновление поставлено в очередь.
-
Method:
POST -
Path:
/api/hosting/v1/accounts/{username}/wordpress/{software}/plugins/update
hosting_activateWordPressThemeV1
Активировать установленную тему в установленном WordPress.
Укажите в пути идентификатор установки WordPress (software). Его можно получить из GET /api/hosting/v1/wordpress/installations (поле id).
Операция выполняется асинхронно: успешный ответ означает только то, что задание на активацию поставлено в очередь.
-
Method:
POST -
Path:
/api/hosting/v1/accounts/{username}/wordpress/{software}/themes/activate
hosting_deployWordPressThemeV1
Развернуть тему WordPress из уже загруженного каталога.
Этот endpoint позволяет развернуть тему WordPress, загруженную в каталог сайта.
После развертывания тему можно активировать; этот шаг необязателен.
-
Method:
POST -
Path:
/api/hosting/v1/accounts/{username}/websites/{domain}/wordpress/themes/deploy
hosting_installWordPressThemeV1
Установить тему в уже существующий WordPress.
Укажите в пути идентификатор установки WordPress (software). Его можно получить из GET /api/hosting/v1/wordpress/installations (поле id).
Если выбрана одна из тем Hostinger (hostinger-blog, hostinger-affiliate-theme, hostinger-ai-theme), необязательные поля palette, layout и font передаются специальному установщику. Значения по умолчанию: palette1, layout1 и default. Для остальных тем эти поля игнорируются.
Операция выполняется асинхронно: успешный ответ означает только то, что задание на установку поставлено в очередь, а не то, что тема уже готова.
-
Method:
POST -
Path:
/api/hosting/v1/accounts/{username}/wordpress/{software}/themes/install
hosting_listInstalledWordPressThemesV1
Получить список тем, установленных в WordPress, включая их статус, доступные обновления и известные уязвимости.
Укажите в пути идентификатор установки WordPress (software). Его можно получить из GET /api/hosting/v1/wordpress/installations (поле id).
-
Method:
GET -
Path:
/api/hosting/v1/accounts/{username}/wordpress/{software}/themes
hosting_listWordPressThemesV1
Получить список тем WordPress, доступных для установки.
Используйте возвращённые значения slug в запросе POST /api/hosting/v1/accounts/{username}/wordpress/{software}/themes/install.
-
Method:
GET -
Path:
/api/hosting/v1/wordpress/themes
hosting_uninstallWordPressThemesV1
Удалить одну или несколько тем из WordPress.
Укажите в пути идентификатор установки WordPress (software). Его можно получить из GET /api/hosting/v1/wordpress/installations (поле id).
Операция выполняется асинхронно: успешный ответ означает только то, что задание на удаление поставлено в очередь.
-
Method:
POST -
Path:
/api/hosting/v1/accounts/{username}/wordpress/{software}/themes/uninstall
hosting_updateWordPressThemesV1
Обновить одну или несколько установленных тем до последних версий в WordPress.
Укажите в пути идентификатор установки WordPress (software). Его можно получить из GET /api/hosting/v1/wordpress/installations (поле id).
Операция выполняется асинхронно: успешный ответ означает только то, что задание на обновление поставлено в очередь.
-
Method:
POST -
Path:
/api/hosting/v1/accounts/{username}/wordpress/{software}/themes/update