Перед началом использования 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. Дата отключения услуги