API для работы с хостингом beta
Примеры использования API хостинга:
Доступ к API хостинга активен в любом оплаченном тарифном плане. Для тестовых или бесплатных аккаунтов API не работает. Принципы работы и примерыДоступ происходит по протоколу HTTPS по базовому адресу https://www.1gb.ua/api/. Параметры большинства запросов можно передавать с помощью GET или POST параметров. Ответ содержит объект или массив объектов по стандарту JSON. Перед началом работы с API требуется получить token для дальнейшей авторизации. Это делается следующим образом (приведены примеры использованиЯ GET параметров):
Последний запрос возвращает string, в нем token, его нужно запомнить и использовать для последующей авторизации. Token утрачивает силу при смене главного пароля аккаунта, существует также возможность деактивировать отдельные token-ы со страницы кабинета "смена главного пароля аккаунта". Примеры дальнейших запросов: Ответы API с HTTP кодом 200 обозначают успешное исполнение операции. В ответном JSON может содержаться два разных типа:
Команды API и общие соглашенияБольшинство команд API, таких как /list, возвращают внутренние структуры из базы данных хостинга, которые содержат сотни полей. Документировать их трудоемко, поэтому рекомендуем просто смотреть на вывод соответствующих команд и анализировать структуры данных по очевидным названиям полей. В том случае, если трактовка полей вызывает затруднения, пишите на support@1gb.ua, поможем разобраться. В настоящее время идет процесс наполнения/создания полной документации к API на основе http://swagger.io/, где будет систематизирована вся доступная информация. Общедоступные на данный момент командыhttps://www.1gb.ua/api + адрес из списка ниже. Обязательный параметр каждой команды - _token_. Остальные параметры приведены после команды. В квадратных скобках - не обязательные. В круглых - примеры или умолчания. /auth/start login /auth/login login salt response /c2dmkey/set _key_ Internal usage, do not call. /gcmkey/set _key_ Internal usage, do not call. /iospushkey/set _key_ Internal usage, do not call. /billing/info /billing/limits /billing/balance /billing/balance.lic /billing/debt /updates/list _key_ - first ID or 0 to show all /updates/last /vds/list [_key_] - /vds/list|id /vds/ip/list [_key_] - /vds/list|id /vds/templates-list /vds/create [type] (vds.dynamic) vz1|vz2|vz3|vz4|vz5|vds.dynamic [cr_hvmem] (2048) [cr_hvdsk] (30) [cr_hvcpu] (2) [template] (win2012R2x64) [force_memo] [hv_1gb_panel_version] [panel_install] - 1|0 [cr_ssd1] - 1|0 [cr_hv_all_system] - 1|0 /vds/update _key_ - /vds/list|id [cr_hvmem] (2048) [cr_hvdsk] (30) [cr_hvcpu] (2) /vds/ip/add _key_ - /vds/list|id /vds/ip/delete _key_ - /vds/list|id del_ip /vds/reboot _key_ - /vds/list|id /vds/delete _key_ - /vds/list|id [force_critical] - 1|0 /vds/online _key_ - /vds/list|id online - 1|0 /email/list /email/alias/list /email/add add_email /email/delete _key_ - email address (string) /email/alias/delete _key_ - email address (string) /website/add name - website name (temp subdomain), keep simple, unique and short srv_type - 99901 Best for PHP 99902 Best for ASP, ASP.NET 99903 Best for Static Content 8 .NET 2 - 3.5 99904 .NET 4+, .Core 1 Legacy ASP + .NET 2 - 3.5 4 mod_php 5.2 9 mod_php 5.3 10 mod_php 5.4 11 mod_php 5.5 12 mod_php 5.6 13 mod_php 7 15 mod_php 7.1 16 mod_php 7.2 17 mod_php 7.3 18 mod_php 7.4 19 mod_php 8.0 5 PHP - FastCGI 6 PHP - CGI (not recommended) 20008 Frankfurt - .NET 2 - 3.5 29994 Frankfurt - .NET 4+ 2004 Frankfurt - mod_php 5.2 2009 Frankfurt - mod_php 5.3 2010 Frankfurt - mod_php 5.4 2011 Frankfurt - mod_php 5.5 2005 Frankfurt - PHP - FastCGI /website/list /website/delete _key_ - /website/list|id /ftp/list (not recommented - use /website/ API) /ftp/delete _key_ - /ftp/list|id (not recommented - use /website/ API) /dns/list /dns/add add_dns_zone [add_dns_record] [iis_site_for_dns] - /website/list|id OR "ip_a.b.c.d" string to bind to VDS [bind_only] - 1|0 /dns/bind _key_ - /dns/list|id [dns_to] - /website/list|id OR "ip_a.b.c.d" string to bind to VDS /dns/delete _key_ - /dns/list|id /dns/raw/managedmx _key_ - /dns/list|id upd_managed_mx - 1 managed_mx - 1|0 - add/keep/update (1) or delete (0) hosting-managed root MX record /dns/raw _key_ - /dns/list|id s_del = 1 to delete record, DO NOT specify ANY s_del to create record s_add = 1 to create record, DO NOT specify ANY s_add to delete record dns_type = A,MX,CNAME,AAAA,NS,TXT,SRV dns_name = record name or @ for root dns_value = record content, dnscmd.exe format (A: [ip], CNAME: [name], MX: [priority] [target]) /database/list /mssql/list /dns/prolong/list /chat/key
Хотите стать клиентом нашего хостинга?
Попробуйте наши услуги и сервис.
Тестовый период до 10 дней,  регистрация
занимает всего одну минуту.
Будем рады видеть вас нашим клиентом! Оглавление технической документации
| 
|
| |||||||||||||||||
|
|
 |  |  | |  | |  |
API для работы с хостингом позволяет автоматизировать
управление ресурсами и анализ данных.
| | Наверх | |||
| ||||