API функции для автоматизации продажи Ваших проектов
- Dmitry Sherstnev (Unlicensed)
- ZL Support
Пожалуйста, ознакомьтесь с Правилами использования материалов на данном ресурсе
WebService API расположен по адресу: https://userarea.zennolab.com/BotStore.asmx
Загружать Ваши проекты можно по адресу: https://userarea.zennolab.com/ru/userarea/Bots.aspx
Как подключить WebService к проектам написанным на ASP.NET смотрите тут: https://docs.microsoft.com/ru-ru/previous-versions/visualstudio/visual-studio-2008/d9w023sx(v=vs.90)?redirectedfrom=MSDN
Как работать с WebService в PHP смотрите тут: http://php.net/manual/ru/book.soap.php
Как работать с WebService в Python смотрите тут: https://wiki.python.org/moin/WebServices (SOAP section).
На данный момент доступны следующие функции:
Получение информации о загруженных в UserArea ботах: GetBotList
Работа с продажами ботов: GetSales, SaleBots, RefundSale, ChangeSubscription
Работа с пользователями: GetCurrentCustomerEmail, RegisterCustomer, ResetPassword, GetCustomerBoxLink
Управление ботами: CreateBot, UploadBotContent
GetBotList
Описание:
Получает список ботов, зарегистрированных в UserArea.
Принимает:
string login - Ваш e-mail для входа в userarea.zennolab.com
string password - md5 хэш от Вашего пароля для userarea.zennolab.com
Возвращает:
Массив объектов BotInfo
public class BotInfo
{
// уникальный идентификатор бота
public int Id;
// имя бота
public string Name;
// название файла
public string FileName;
// когда создан
public DateTime Created;
// когда последний раз обновлен
public DateTime Modified;
// ваш комментарий
public string Comment;
// размер в байтах
public int Size;
}GetSales
Описание:
Получает список Ваши продаж, продажи можно запросить для конкретного клиента, указав его e-mail.
Принимает:
string login - Ваш e-mail для входа в userarea.zennolab.com
string password - md5 хэш от Вашего пароля для userarea.zennolab.com
string filterByCustomerEmail - e-mail пользователя, которому продавали, если указать пустую строку, то получите весь список продаж
Возвращает:
Массив объектов SaleInfo:
public class SaleInfo
{
// уникальный идентификатор продажи
public int Id;
// дата продажи
public DateTime SaleDateTime;
// email покупателя
public string CustomerEmail;
// id ботов через запятую
public string Bots;
// был ли Refund по данной продаже
public bool HasRefund;
// продажа является подпиской или нет
public bool IsSubscription;
// когда заканчивается подписка
public DateTime? SubscriptionDueDate;
// в каких продуктах может работать проект
// 1 - только в ZennoBox, 2 - только в ZennoPoster, 3 - в ZennoBox и ZennoPoster
public int ForProducts;
}SaleBots
Описание:
Продаёт указанных ботов указанному покупателю.
Принимает:
string login - Ваш e-mail для входа в userarea.zennolab.com
string password - md5 хэш от Вашего пароля для userarea.zennolab.com
string customerEmail - e-mail покупателя
string ids - уникальные идентификаторы Ваших ботов, если нужно продать сразу несколько ботов, следует указывать id через запятую
bool isSubscription - true если это подписка и false если обычная продажа
int subscriptionDaysCount - количество дней подписки, если это обычная продажа, то следует указать 0
int forProducts - в каких продуктах может работать проект 1 - только в ZennoBox, 2 - только в ZennoPoster, 3 - в ZennoBox и ZennoPoster
Возвращает:
int id продажи
RefundSale
Описание:
Осуществляет отзыв продажи. Бот становится неработоспособным у клиента.
Принимает:
string login - Ваш e-mail для входа в userarea.zennolab.com
string password - md5 хэш от Вашего пароля для userarea.zennolab.com
int saleId - id продажи
Возвращает:
Одну из следующих строк:
Ok - операция выполнена успешно.
Exception - произошла внутренняя ошибка, если ошибка повторяется, Вам следует обратиться в службу поддержки ZennoLab.
NoSuchSale - Вы указали неверный id продажи.
NoSuchUser - Вы указали неверные данные авторизации.
RefundTimeout - Вы пытаетесь вернуть деньги за продажу, которая была сделана до приобретения Developer license, автоматически Вы можете это сделать только в течении 30 дней, если Вам нужно сделать отзыв продажи, после 30 дней, Вы можете сделать это только через интерфейс в административной панели, комиссия ZennoLab при этом возвращена не будет.
ChangeSubscription
Описание:
Изменяет параметры подписки.
Принимает:
string login - Ваш e-mail для входа в userarea.zennolab.com
string password - md5 хэш от Вашего пароля для userarea.zennolab.com
int saleId - id продажи
int addDays - количество дней, на которые надо продлить подписку, можно указать отрицательное число, тогда срок подписки будет уменьшен
Возвращает:
Одну из следующих строк:
Ok - операция выполнена успешно.
Exception - произошла внутренняя ошибка, если ошибка повторяется, Вам следует обратиться в службу поддержки ZennoLab.
NoSuchSale - Вы указали неверный id продажи.
NoSuchUser - Вы указали неверные данные авторизации.
GetCurrentCustomerEmail
Описание:
Функция позволяет проверить, зарегистрирован у нас уже пользователь или нет.
Принимает:
string login - Ваш e-mail для входа в userarea.zennolab.com
string password - md5 хэш от Вашего пароля для userarea.zennolab.com
string customerEmail - e-mail Вашего клиента
Возвращает:
Возвращает актуальный (пользователь мог сменить e-mail регистрации) e-mail пользователя. Если пользователь не зарегистрирован, то Вы получаете ответ nosuchuser@zennolab.com
RegisterCustomer
Описание:
Регистрирует пользователя в личном кабинете ZennoLab.
Принимает:
string login - Ваш e-mail для входа в userarea.zennolab.com
string password - md5 хэш от Вашего пароля для userarea.zennolab.com
string email - e-mail Вашего клиента
string lang - язык Вашего клиента, может принимать 2 значения ru и en
Возвращает:
При успешной регистрации Вы получаете запись вида: «Pass:password», где password пароль зарегистрированного пользователя от личного кабинета.
ResetPassword
Описание:
Позволяет поменять пароль пользователя ZennoLab, если Вы его зарегистрировали через API.
Принимает:
string login - Ваш e-mail для входа в userarea.zennolab.com
string password - md5 хэш от Вашего пароля для userarea.zennolab.com
string email - e-mail Вашего клиента
Возвращает:
При успехе операции Вы получаете запись вида: «Pass:password», где password пароль пользователя от личного кабинета.
GetCustomerBoxLink
Описание:
Возвращает прямую ссылку для скачивания ZennoBox для Вашего клиента.
Принимает:
string login - Ваш e-mail для входа в userarea.zennolab.com
string password - md5 хэш от Вашего пароля для userarea.zennolab.com
string customerEmail - e-mail Вашего клиента
Возвращает:
Ссылку вида:
https://userarea-us.zennolab.com/download/ZennoBox*.exeгде вместо * указывается последняя версия и язык ZennoBox доступного для Вашего клиента.
CreateBot
Описание:
Регистрирует нового бота в административной панели, чтобы залить бота после регистрации используете UploadBotContent.
Принимает:
string login - Ваш e-mail для входа в userarea.zennolab.com
string password - md5 хэш от Вашего пароля для userarea.zennolab.com
string botName - имя бота в административной нанели
string fileName - имя файла проекта, который будет создан у клиента
string comment - Ваш комментарий
Возвращает:
Одну из следующих строк:
Ok:{bot id} - операция выполнена успешно, возвращается id созданного бота.
Exception - произошла внутренняя ошибка, если ошибка повторяется, Вам следует обратить в службу поддержки ZennoLab.
NoSuchUser - Вы указали неверные данные авторизации.
UploadBotContent
Описание:
Загружает новое содержимое бота в административную панель.
Принимает:
string login - Ваш e-mail для входа в userarea.zennolab.com
string password - md5 хэш от Вашего пароля для userarea.zennolab.com
int botId - id бота в административной панели, id Ваших ботов можно узнать используя функцию GetBotList
string botContent - содержимое проекта, конвертированное в base64 строку
string comment - Ваш комментарий
Возвращает:
Одну из следующих строк:
Ok - операция выполнена успешно.
Exception - произошла внутренняя ошибка, если ошибка повторяется, Вам следует обратить в службу поддержки ZennoLab.
NoSuchBot - Вы указали неверный id бота.
NoSuchUser - Вы указали неверные данные авторизации.