Инструменты пользователя

Инструменты сайта


Боковая панель

Перевод этой страницы:

ru:devlicense:api

API функции для автоматизации продажи ваших проектов.

WebService API расположен по адресу: https://userarea.zennolab.com/BotStore.asmx
Загружать ваши проекты можно по адресу: https://userarea.zennolab.com/ru/userarea/Bots.aspx
Как подключить WebService к проектам написанным на ASP.NET смотри тут: http://msdn.microsoft.com/en-us/library/d9w023sx(v=vs.90).aspx
Как работать с WebService в PHP смотри тут: http://php.net/manual/en/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 - ваш email для входа в 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

Описание:
Получает список ваши продаж, продажи можно запросить для конкретного клиента, указав его email.

Принимает:
string login - ваш email для входа в userarea.zennolab.com
string password - md5 хэш от вашего пароля для userarea.zennolab.com
string filterByCustomerEmail - email пользователя, которому продавали, если указать пустую строку, то получите весь список продаж

Возвращает:
Массив объектов 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 - ваш email для входа в userarea.zennolab.com
string password - md5 хэш от вашего пароля для userarea.zennolab.com
string customerEmail - email покупателя
string ids - уникальные идентификаторы ваших ботов, если нужно продать сразу несколько ботов, следует указывать id через запятую
bool isSubscription - true если это подписка и false если обычная продажа
int subscriptionDaysCount - количество дней подписки, если это обычная продажа, то следует указать 0
int forProducts - в каких продуктах может работать проект 1 - только в ZennoBox, 2 - только в ZennoPoster, 3 - в ZennoBox и ZennoPoster

Возвращает:
int id продажи

RefundSale

Описание:
Осуществляет отзыв продажи. Бот становится неработоспособным у клиента.

Принимает:
string login - ваш email для входа в 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 - ваш email для входа в userarea.zennolab.com
string password - md5 хэш от вашего пароля для userarea.zennolab.com
int saleId - id продажи
int addDays - количество дней, на которые надо продлить подписку, можно указать отрицательное число, тогда срок подписки будет уменьшен.

Возвращает:
Одну из следующих строк:
Ok - операция выполнена успешно.
Exception - произошла внутренняя ошибка, если ошибка повторяется, вам следует обратить в службу поддержки ZennoLab.
NoSuchSale - вы указали неверный id продажи.
NoSuchUser - вы указали неверные данные авторизации.

GetCurrentCustomerEmail

Описание:
Функция позволяет проверить, зарегистрирован у нас уже пользователь или нет.

Принимает:
string login - ваш email для входа в userarea.zennolab.com
string password - md5 хэш от вашего пароля для userarea.zennolab.com
string customerEmail - email вашего клиента

Возвращает:
Возвращает актуальный (пользователь мог сменить email регистрации) email пользователя. Если пользователь не зарегистрирован, то вы получаете ответ nosuchuser@zennolab.com

RegisterCustomer

Описание:
Регистрирует пользователя в личном кабинете ZennoLab

Принимает:
string login - ваш email для входа в userarea.zennolab.com
string password - md5 хэш от вашего пароля для userarea.zennolab.com
string email - email вашего клиента
string lang - язык вашего клиента, может принимать 2 значения ru и en

Возвращает:
При успешной регистрации вы получаете запись вида: «Pass:password», где password пароль зарегистрированного пользователя от личного кабинета.

ResetPassword

Описание:
Позволяет поменять пароль пользователя ZennoLab, если вы его зарегистрировали через API

Принимает:
string login - ваш email для входа в userarea.zennolab.com
string password - md5 хэш от вашего пароля для userarea.zennolab.com
string email - email вашего клиента

Возвращает:
При успехе операции вы получаете запись вида: «Pass:password», где password пароль пользователя от личного кабинета.

Описание:
Возвращает прямую ссылку для скачивания ZennoBox для вашего клиента

Принимает:
string login - ваш email для входа в userarea.zennolab.com
string password - md5 хэш от вашего пароля для userarea.zennolab.com
string customerEmail - email вашего клиента

Возвращает:
Ссылку вида

https://userarea-us.zennolab.com/download/ZennoBox*.exe

где вместо * указывается последняя версия и язык ZennoBox доступного для вашего клиента.

CreateBot

Описание:
Регистрирует нового бота в админке, чтобы залить бота после регистрации используете UploadBotContent

Принимает:
string login - ваш email для входа в 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 - ваш email для входа в 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 - вы указали неверные данные авторизации.

ru/devlicense/api.txt · Последние изменения: 2016/11/16 13:13 — adminsama