Использование API хостинга

• Получение ключа API
• Как создать контейнер
• Как создать сайт на wordpress
• Как создать сайт на PHP с mysql.
• Как изменить настройки PHP
• Как подключить к сайту бесплатный SSL сертификат

Большинство наших клиентов работают с хостингом через панель управления. Нашим клиентам, которым требуется автоматизировать работу с хостингом без входа в панель управления, мы можем предложить API.

С его помощью можно делать все тоже самое, что и через панель — создавать и удалять сайты или контейнеры, менять настройки PHP, перезагружать сайты и многое другое.

Получение ключа API

Откройте раздел “Ключ API” в панели управления. Если ключ еще не создан, то нажмите “Создать ключ”.

При помощи API ключа получите токен, который будет действовать 24 часа:

Запрос

curl -XPOST https://panel.netangels.ru/api/gateway/token/ -d 'api_key=3fyL8piL6goKDkWa8ctK6AdQsfW79N5uG9cLD71hfjc3rHKhXfQ7t96b'

Ответ

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJsb2dpbiI6InUzNzY2MyIsImV4cCI6MTU2NjQxMjc3M30.FQNDFOqJDaLvZgiqxhDp9jljulGDoeT5zlQ4aZArLfs"
}

Более подробно получение токена описано на странице https://api.netangels.ru/gateway/#token-obtain

Сохраним токен как переменную, чтобы проще было обращаться к нему:

export TOKEN="eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJsb2dpbiI6InUzNzY2MyIsImV4cCI6MTU2NjQxMjc3M30.FQNDFOqJDaLvZgiqxhDp9jljulGDoeT5zlQ4aZArLfs"

Теперь все готово, чтобы полноценно работать с API.

Как создать контейнер

curl --request POST https://api-ms.netangels.ru/api/v1/hosting/containers/ -H "Authorization: Bearer ${TOKEN}" -H "Content-Type: application/json" --data '{ "name": "Мои сайты", "memory_limit": 512, "quota": 5120,  "redis": 512, "memcache": 512 }'

Как создать сайт на wordpress

При создании контейнера в ответе нам был показан уникальный номер контейнера “id”: 10214. Он понадобится нам для создания сайта в поле container_id.

Запрос

curl --request POST https://api-ms.netangels.ru/api/v1/hosting/virtualhosts/install/ -H "Authorization: Bearer ${TOKEN}" -H "Content-Type: application/json" --data '{"name": "apitest.na4u.ru", "image": "wordpress", "force_https": true, "charset": "utf-8", "aliases": ["www.apitest.na4u.ru"], "main_alias": "apitest.na4u.ru", "container_id": "10214", "admin_email": "info@netangels.ru", "admin_password": "Ra7Ia2oh" }'

Как создать сайт на PHP с mysql.

Мы можем создать сайт

curl --request POST 'https://api-ms.netangels.ru/api/v1/hosting/virtualhosts/' --header "Authorization: Bearer ${TOKEN}" --header "Content-Type: application/json" --data '{
          "name": "apitest-phpengine.na4u.ru",
          "engine": "php",
          "dbms_type": "mysql",
          "force_https": true,
          "charset": "utf-8",
          "aliases": ["www.apitest-phpengine.na4u.ru"],
          "main_alias": "apitest-phpengine.na4u.ru",
          "container_id": "10214"
    }'

При создании сайта в ответе нам был показан уникальный номер сайта “id”: 19618. Он понадобится нам для изменения настроек PHP.

Как изменить настройки PHP

Сначала получим все настройки PHP. Для удобства будем использовать утилиту jq, которая позволит легко фильтровать вывод. Так же сохраним вывод в файл directives.txt:

curl --request GET 'https://api-ms.netangels.ru/api/v1/hosting/virtualhosts/19540/' --header "Authorization: Bearer ${TOKEN}" --header "Content-Type: application/json" | jq .engine_directives > directives.txt

В файле directives.txt изменим значения параметра log_errors, установив значение 0. Загрузим PHP настройки обратно:

curl --request PUT 'https://api-ms.netangels.ru/api/v1/hosting/virtualhosts/19618/engine-settings/' --header "Authorization: Bearer ${TOKEN}" --header "Content-Type: application/json" -d @directives.txt

Проверим, что настройки действительно изменились:

curl --request GET 'https://api-ms.netangels.ru/api/v1/hosting/virtualhosts/19618/php-directives/search/?term=log_errors' --header "Authorization: Bearer ${TOKEN}" --header "Content-Type: application/json"

Ответ сервера:

[
  "log_errors = 0",
  "log_errors_max_len = 1024"
]

Как подключить к сайту бесплатный SSL сертификат

curl --request PUT 'https://api-ms.netangels.ru/api/v1/hosting/virtualhosts/19618/order-certificate/' --header "Authorization: Bearer ${TOKEN}"

Готово! В данной статье мы показали только небольшую часть действий, которую можно выполнить через API. Вы можете ознакомиться с подробной документацией по всем вызовам API.