Основные операции API

Перед началом использования API необходимо связаться с администрацией для подключения. Все данные должны быть в UTF-8.

Методы XML-RPC:

check_login


Проверка на занятость логина
Принимает аргумент login, например vasya, возвращает 1 если такой юзер есть иначе 0

reg_user


Регистрация юзера и сайта
принимает аргументы:
1. Название сайта(компании)
2. Логин
3. Пароль( в чистом виде)
4. ID дизайна (число, доступные варианты в методе design_list )
5. email
6. ID услуги(число, доступные варианты в методе service_list ). Должна быть демо услуга по выбранному тарифу.
7. Контактное лицо
8. Опциональный параметр - полное доменное имя

Этот метод валидирует входные данные(не пропустит неверные id или занятый логин и вернет Fault по стандарту XML-RPC)
В случае если все ок, вернет массив array(http://ru.wikipedia.org/wiki/XML-RPC), первый элемент ID сайта, второй - на всякий случай, полный адрес сайта.

При создании сайта автоматически подключается демо-услуга на срок 14 дней, если ID аргумента 6 не является ID услуги.
Аргумент 6 для сохранения совместимости может принимать ID Типа сайта(число, доступные варианты в методе acc_type_list ).


balance_up


Пополнения баланса пользователя
принимает аргументы:
1. ID юзера или логин юзера
2. Сумма (тип double )
Если ID юзера и сумма корректны - вернет 1


design_list


без аргументов
Вернет массив, каждый из элементов которого - также массив, а элементы его такие:
1. ID дизайна
2. Полный путь для картинки

acc_type_list


без аргументов, либо аргументом принимает домен сайта. Если без аргументов вернет все варианты доступные партнеру, если указан сайт, то варианты доступные для него.
Вернет аналогично design_list, элементы внутреннего массива:
1. ID типа аккаунта
2. Название аккаунта

check_email


принимает аргументом email адрес и возвращает 1, если такой адрес уже есть, и 0 в противном случае.


add_site


Метод позволяет добавлять сайт в существующий аккаунт
Принимает аргументы:
1. Название сайта
2. Доменное имя(полное)
3. ID дизайна
4. Логин, к которому привязывается сайт
5. ID услуги(число, доступные варианты в методе service_list ). Должна быть демо услуга по выбранному тарифу.
Если все ок, вернет массив первый элемент ID сайта, второй - на всякий случай, полный адрес сайта.

При создании сайта автоматически подключается демо-услуга на срок 14 дней, если ID аргумента 5 не является ID услуги.
Аргумент 6 для сохранения совместимости может принимать ID Типа сайта(число, доступные варианты в методе acc_type_list ).



check_status


Принимает аргументом либо ID сайта либо доменное имя
Вернет 1 - если сайт создан и работает с положительным или неотрицательным балансом
Вернет 0 - если сайт в процессе создания
Вернет -1 - если сайт отключен за неуплату
Вернет -2 - если сайт отключен вручную

disable_site


Отключает сайт и приостанавливает списание средств за него
Принимает аргументом доменное имя
Возвращает 1, а если сайт был до этого отключен то 0

С введением новой схемы платежей этот метод более не работает таким образом, а просто блокирует сайт


enable_site


Включает сайт и возобновляет списание средств за него
Принимает аргументом доменное имя
Возвращает 1, а если сайт был до этого включен то 0

delete_site


Удаляет сайт полностью, и все что с ним связано.
Принимает аргументом доменное имя
Возвращает 1 в случае успеха

delete_alias


Удаляет алиас сайта
Принимает аргументом доменное имя
Возвращает 1 в случае успеха

change_site_tarif


Меняет тариф сайта
Аргументы:
1. доменное имя сайта
2. ID нового тарифа
3. (Опционально) Любой аргумент
Функция проверяет возможность смены тарифа, и не даст понизить тариф если более низкий тариф не удовлетворяет использованным функциям и ресурсам. Например, чтобы перейти с Магазин на Визитку, нужно удалить все товары.

Если не указан третий аргумент(произвольный), то:
При смене тарифа производится перерасчет неиспользованной части подключенной услуги и сумма либо возвращается на баланс, либо списывается дополнительная с баланса. При невозможности повысить тариф, будет выдана ошибка.
В случае успеха функция вернет текущий остаток на балансе клиента.

Если указан третий аргумент, то смена тарифа производится на основе пересчета сроков(а не денег). Будет возвращена новая дата отключения сайта.


change_domain


Меняет домен сайта
Аргументы:
1. текущее доменное имя сайта
2. новое доменное имя сайта
Возвращает 1 в случае успеха


add_dns_zone


Создает зону для домена
Аргументы:
1. текущее доменное имя сайта
Возвращает 1 в случае успеха

change_site_owner


Меняет владельца сайта
Аргументы:
1. Доменное имя сайта
2. Логин нового пользователя
Возвращает 1 в случае успеха

connect_service


Подключает услугу
Аргументы:
1. Доменное имя сайта
2. id услуги (полный список в service_list)

Возвращает список из 3-х значений в случае успеха:
1. Полная стоимость услуги
2. Стоимость для партнера
3. Остаток на балансе у клиента


service_list


Список услуг
без аргументов, либо аргументом принимает домен сайта. Если без аргументов вернет все варианты доступные партнеру, если указан сайт, то варианты доступные для него.
Вернет аналогично design_list, элементы внутреннего массива:
1. ID услуги
2. Название услуги
3. Стоимость услуги
4. Срок услуги в днях

connected_service_list


Выводит все подключенные услуги
Аргументы:
1. Доменное имя сайта
Вернет аналогично design_list, элементы внутреннего массива:
1. Название услуги
2. в случае если это основная услуга "обслуживание сайта", то exclusive, иначе regular
3. Дата отключения услуги

Остались вопросы?