{"schema_version":"1.0","service":"Publicasta","type":"article","id":519,"slug":"hosting_api","title":"API хостинга","excerpt":"Где взять API-ключ, на какой домен направлять запросы и какой пароль используется. Первый безопасный запрос чтения аккаунта, обработка результата и подготовка обращения в поддержку.","language":"ru","default_language":"en","canonical_url":"https://hosting-help.livegpstracks.ru/hosting_api?lang=ru","image":{"url":"https://hosting-help.livegpstracks.ru/storage/projects/45/pages/519/2026/09/fe44d442-2654-434e-aa6c-b9a403e42c21.webp","alt":"API-ключ и ссылка на справочник в настройках; показан неработающий учебный ключ"},"publisher":{"id":45,"slug":"hosting_livegpstracks","name":"Хостинг LiveGPSTracks: руководство администратора","url":"https://hosting-help.livegpstracks.ru"},"author":{"name":"LiveGPSTracks"},"published_at":"2026-09-06T09:17:56+00:00","updated_at":"2026-09-06T09:17:56+00:00","content_markdown":"[Оглавление руководства](./contents)\n\n API позволяет связать хостинг с вашим интернет-магазином, CRM или внутренней системой: получать сведения об аккаунтах, создавать клиентов, работать с устройствами и автоматизировать отдельные операции. Для обычной работы через кабинет API не нужен.\n\n Эта глава — отправная точка для интегратора, а не замена полного справочника. Операции, меняющие баланс, доступ или устройства, нужно разрабатывать и проверять отдельно от простого чтения.\n\n ## Где взять ключ и справочник\n\n Откройте **Настройки → API ключ**. Рядом находится ссылка на документацию. На учебном снимке ключ заменён на неработающее значение `DEMO-KEY-NOT-VALID`.\n\n Доступен [русский PDF-справочник API](https://hosting.livegpstracks.com/hostingapi.pdf). Это справочник старого интерфейса: он полезен для перечня команд, но в примерах и пояснениях встречаются неточности. При расхождении ответа с примером передайте интегратору фактический ответ и уточните поведение у поддержки.\n\n ![API-ключ и ссылка на справочник в настройках; показан неработающий учебный ключ](https://hosting-help.livegpstracks.ru/storage/projects/45/pages/519/2026/09/fe44d442-2654-434e-aa6c-b9a403e42c21.webp)\n\n *Ключ берётся из настроек владельца, а не из карточки клиента. DEMO-KEY-NOT-VALID нельзя использовать для запроса.*\n\n ## Адрес и авторизация\n\n Запросы направляются на **домен вашего клиентского сайта**, например на `/api/v1.1/account`. Не подставляйте вместо него адрес кабинета `hosting.livegpstracks.com`: по домену определяется сайт хостинга.\n\n Основные параметры:\n\n<table>\n<thead>\n<tr>\n<th>Параметр</th>\n<th>Значение</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>xusername</code></td>\n<td>Логин владельца хостинга</td>\n</tr>\n<tr>\n<td><code>xpassmd</code></td>\n<td>MD5 пароля основного аккаунта владельца</td>\n</tr>\n<tr>\n<td><code>xkey</code></td>\n<td>Его API-ключ из настроек</td>\n</tr>\n<tr>\n<td><code>username</code></td>\n<td>Логин клиента, с которым работает команда</td>\n</tr>\n<tr>\n<td><code>action</code></td>\n<td>Действие выбранного метода</td>\n</tr>\n</tbody>\n</table>\n\n **Пароли могут различаться.** Изменение пароля в кабинете хостинга не обновляет пароль основного аккаунта. В старом API `account` проверяется именно основной аккаунт. Не используйте здесь пароль клиента.\n\n MD5 не делает параметр безопасным для публикации: для этой авторизации он сам является секретом. Передавайте все параметры запроса вместе в POST по HTTPS с корректным сертификатом. Не размещайте их в URL, клиентском JavaScript, открытых логах и системах аналитики. Если HTTPS вашего домена ещё не настроен, сначала решите этот вопрос с поддержкой.\n\n ## Начните с чтения аккаунта\n\n Первый тест — `action=get` для уже существующего учебного клиента. Он не пополняет баланс, не создаёт устройство и не меняет тариф.\n\n Структура запроса ниже иллюстративная. Домен и значения вымышленные; это не готовые рабочие реквизиты:\n\n ```http\nPOST /api/v1.1/account HTTP/1.1\nHost: monitoring.northline.example\nContent-Type: application/x-www-form-urlencoded\n\naction=get&username=riverfleet&xusername=northlineadmin&xpassmd=OWNER_PASSWORD_MD5&xkey=API_KEY\n```\n\n Тело запроса кодируется как обычная HTML-форма. Ответ — JSON. Проверяйте не только HTTP-статус, но и поле `result`: код успешного выполнения — `1000`. Ответ может содержать отдельный элемент результата и отдельный массив данных; не считайте весь ответ одним объектом клиента.\n\n После успеха сравните логин, баланс, валюту и назначенные данные с кабинетом. Только затем переходите к следующему методу.\n\n ## Что можно автоматизировать\n\n - Работа с аккаунтами: чтение, создание, включение и отключение, изменение отдельных назначений и данных.\n- Работа с устройствами: получение списка, добавление и другие команды из справочника.\n- Получение координат через предусмотренные методы API.\n\n Не все команды являются безопасным просмотром. Например, пополнение и активация устройства могут менять финансовые данные. После таймаута сначала проверьте результат операции; автоматический повтор без такой проверки может выполнить действие ещё раз. Начинайте интеграцию на отдельном тестовом клиенте и не запускайте массовые действия первым запросом.\n\n ## Если API не отвечает как ожидается\n\n - HTML-страница или nginx 404 вместо JSON: проверьте домен и точный маршрут, затем обратитесь в поддержку. Это не подтверждение неверного пароля.\n- `1005` или `1006`: проверьте владельца, домен сайта, комплект параметров, основной пароль и актуальность ключа.\n- `1001`: проверьте обязательные поля выбранной команды.\n- `1012` при чтении аккаунта: проверьте логин клиента и его принадлежность вашему хостингу.\n\n Для обращения сохраните время, адрес метода без секретных параметров, действие, HTTP-статус и очищенный JSON. После смены ключа обновите все интеграции.\n\n [Вернуться к оглавлению](./contents)","available_translations":[{"language":"en","title":"Hosting API","html_url":"https://hosting-help.livegpstracks.ru/hosting_api?lang=en","markdown_url":"https://hosting-help.livegpstracks.ru/hosting_api.md?lang=en","json_url":"https://hosting-help.livegpstracks.ru/hosting_api.json?lang=en","api_url":"https://hosting-help.livegpstracks.ru/api/public/v1/channels/hosting_livegpstracks/articles/hosting_api?lang=en"},{"language":"ru","title":"API хостинга","html_url":"https://hosting-help.livegpstracks.ru/hosting_api?lang=ru","markdown_url":"https://hosting-help.livegpstracks.ru/hosting_api.md?lang=ru","json_url":"https://hosting-help.livegpstracks.ru/hosting_api.json?lang=ru","api_url":"https://hosting-help.livegpstracks.ru/api/public/v1/channels/hosting_livegpstracks/articles/hosting_api?lang=ru"}],"_links":{"self":"https://hosting-help.livegpstracks.ru/hosting_api.json?lang=ru","api":"https://hosting-help.livegpstracks.ru/api/public/v1/channels/hosting_livegpstracks/articles/hosting_api?lang=ru","html":"https://hosting-help.livegpstracks.ru/hosting_api?lang=ru","canonical":"https://hosting-help.livegpstracks.ru/hosting_api?lang=ru","markdown":"https://hosting-help.livegpstracks.ru/hosting_api.md?lang=ru","json":"https://hosting-help.livegpstracks.ru/hosting_api.json?lang=ru","channel":"https://hosting-help.livegpstracks.ru/api/public/v1/channels/hosting_livegpstracks","channel_articles":"https://hosting-help.livegpstracks.ru/api/public/v1/channels/hosting_livegpstracks/articles","search":"https://hosting-help.livegpstracks.ru/api/public/v1/search","documentation":"https://publicasta.com/api-docs#reading-publicasta","openapi":"https://publicasta.com/api-docs/openapi.json","llms":"https://hosting-help.livegpstracks.ru/llms.txt"}}