ISPmanager API. Примеры

Здесь приведены примеры вызова функций ISPmanager с использованием различных языков программирования и команд shell. Для примера рассматривается функция получения списка WWW доменов. Все остальные функции нужно вызывать аналогичным образом. В примерах рассматривается только локальный вызов. Для осуществления удалённого вызова функций ISPmanager необходимо использовать протокол HTTPS вместо HTTP, а также пройти авторизацию, обратившись по URL

https://IP-адрес/manager/ispmgr?out=xml&func=auth&username=имя_пользователя&password=пароль

После этого с помощью функций обработки XML документов либо вручную найти в полученном документе номер сессии и отправлять его с каждым последующим запросом в параметре auth. Время действия номера сессии ограничено 30 минутами, после чего нужно повторно пройти авторизацию.

<?xml version="1.0" encoding="UTF-8"?>
<doc>
<auth id="номер сессии"/>
</doc>
	

Команда fetch

fetch -q -o - "http://IP-адрес/manager/ispmgr?out=xml&func=wwwdomain"

Команда curl

curl -k -s "http://IP-адрес/manager/ispmgr?out=xml&func=wwwdomain"

Язык perl

Для обращения по URL из perl необходимо установить библиотеку LWP. Для работы с XML документами понадобится библиотека XML::LibXML.

#!/usr/bin/perl -w
use CGI::Carp qw(fatalsToBrowser);
print "Content-type: text/html\n\n";

use LWP::UserAgent;
use XML::LibXML;

my $result;

# Создадим псевдо-броузер, который будет "притворяться" MSIE и отправим запрос
$ua = LWP::UserAgent->new;
$ua->agent("Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0)");
my $req = HTTP::Request->new(POST => 'https://IP-адрес/manager/ispmgr');

$req->content("authinfo=логин:пароль&out=xml&func=wwwdomain");

my $res = $ua->request($req);

# Проверим результат
if ($res->is_success) {
	$result = $res->content;
} else {
	die $res->status_line."\n";
}

# После этого переменная $result содержит XML документ со списком WWW доменов,
# либо сообщение об ошибке

my $parser = XML::LibXML->new();
my $doc = $parser->parse_string( $result );
my $root = $doc->documentElement();

# Получим список имён WWW доменов
my @sites = ();
for( $root->findnodes( "elem/name" ) ){
	push @sites, $_->textContent;
}

# выведем результат на экран
for( sort @sites ){
	print $_."<br>\n";
}
	

Язык PHP

Язык PHP предоставляет возможность работы с URL как со стандартными файлами. Для обработки XML документов используется библиотека DOM XML.

<?php
   $result = "";
   $fh = fopen( "http://127.0.0.1/manager/ispmgr?out=xml&func=wwwdomain", "r" );
   while( $data = fread( $fh, 4096 ) ){
     $result .= $data;
   }
   fclose( $fh );

   // После этого переменная $result содержит XML документ со списком WWW доменов,
   // либо сообщение об ошибке

   if( $doc = domxml_open_mem( $result ) ){
      $root = $doc->document_element();
      for( $elem = $root->first_child(); $elem; $elem = $elem->next_sibling() ){
         for( $node = $elem->first_child(); $node; $node = $node->next_sibling() ){
            if( $node->node_name() == "name" ){
               echo $node->get_content();
               echo "\n";
            }
         }
      }
   }
?>