ZennoLab

Automate everything

User Tools

Site Tools


Sidebar

Translations of this page:

en:devlicense:api

API functions to automate sales of your projects.

WebService API is located at: https://userarea.zennolab.com/BotStore.asmx
You can upload your projects/bots here: https://userarea.zennolab.com/ru/userarea/Bots.aspx
How to connect to the WebService in ASP.NET, see here: http://msdn.microsoft.com/en-us/library/d9w023sx(v=vs.90).aspx
How to work with WebService in PHP, see here: http://php.net/manual/en/book.soap.php
How to work with WebService in Python, see here: https://wiki.python.org/moin/WebServices (SOAP section)

At the moment, following functions are avialable:

Retrieving information about uploaded to userarea bots: GetBotList

Sales actions: GetSales, SaleBots, RefundSale, ChangeSubscription

Operations with users: GetCurrentCustomerEmail, RegisterCustomer, ResetPassword, GetCustomerBoxLink

Operations with bots: CreateBot, UploadBotContent

GetBotList

Description :
Gets a list of bots which are registered in userarea.

Inputs:
string login - your email address to login at userarea.zennolab.com
string password - md5 hash of your password at userarea.zennolab.com

Returns:
An array of objects BotInfo

public class BotInfo
{
     // Unique id of bot
     public int Id;
     // Bot's name
     public string Name;
     // File's name
     public string FileName;
     // Date of creation
     public DateTime Created;
     // Date of last update
     public DateTime Modified;
     // Your comment
     public string Comment;
     // Size in bytes
     public int Size;
}

GetSales

Description :
Gets a list of your sales, sales can be requested for a specific client by using his email.

Inputs:
string login - your email address to login at userarea.zennolab.com
string password - md5 hash of your password at userarea.zennolab.com
string filterByCustomerEmail - email of specific client, if you use an empty string, you'll get the full list of sales

Returns:
int id of the sale

SaleBots

Description :
Sale of specified bots to specified buyer.

Inputs:
string login - your email address to login at userarea.zennolab.com
string password - md5 hash of your password at userarea.zennolab.com
string customerEmail - buyer's email
string ids - a unique identifier of your bots, if you want to sell several bots, use several ids, comma separated
bool isSubscription - true if it is subscription, false if it is regular sale
int subscriptionDaysCount - the number of days for subscription, if it is the usual sale, you should specify 0
int forProducts - in which software bot can be used: 1 - ZennoBox only, 2 - ZennoPoster only, 3 - ZennoBox and ZennoPoster

Returns:
An array of objects SaleInfo

public class SaleInfo
{
     // Unique idof the sale
     public int Id;
     // Date of sale
     public DateTime SaleDateTime;
     // Buyer's email
     public string CustomerEmail;
     // Bots ids, separated by comma
     public string Bots;
     // Refund status: was this sale refunded or not
     public bool HasRefund;
     // Subscription status: is it subscription or not
     public bool IsSubscription;
     // When the subscription ends
     public DateTime? SubscriptionDueDate;
     // In which software this bot can be used
     // 1 - only ZennoBox, 2 - only ZennoPoster, 3 - and in ZennoBox ZennoPoster
     public int ForProducts;
}

RefundSale

Description :
Performs refund of sale. Bot will not work on the client's side after that.

Inputs:
string login - your email address to login at userarea.zennolab.com
string password - md5 hash of your password at userarea.zennolab.com
int saleId - id of sale

Returns:
One of the following lines:
Ok - operation was completed successfully.
Exception - internal error occured, if the problem persists, you should contact Zennolab's customer support.
NoSuchSale - you've entered an invalid id of sale.
NoSuchUser - you have specified invalid authorization data.
RefundTimeout - you're trying to get a refund for sale, which was made before purchase of Developer license, automatically you can do this only within 30 days after sale, if you need to block access to your bot after 30 days, you can do this manually in userarea, the commission will not be refunded.

ChangeSubscription

Description :
Changes the parameters of specified subscription.

Inputs:
string login - your email address to login at userarea.zennolab.com
string password - md5 hash of your password at userarea.zennolab.com
int saleId - id of sale
int addDays - the number of days to add to subscription's period, you can specify a negative number, then the subscription's period will be reduced.

Returns:
One of the following lines:
Ok - operation completed successfully.
Exception - internal error occured, if the problem persists, you should contact Zennolab's customer support.
NoSuchSale - you have entered an invalid id of sale.
NoSuchUser - you have specified invalid authorization data.

GetCurrentCustomerEmail

Description :
Function allows you to check, if user with specified email is registered in userarea or not.

Inputs:
string login - your email address to login at userarea.zennolab.com
string password - md5 hash of your password at userarea.zennolab.com
string customerEmail - email of your client

Returns:
Current email of client (user may change email in userarea, in this case you'll get his new email). If user is not registered, then you'll receive [email protected] as return.

RegisterCustomer

Description :
Create new account for client in userarea.

Inputs:
string login - your email address to login at userarea.zennolab.com
string password - md5 hash of your password at userarea.zennolab.com
string email - email of your customer
string lang - language of your client. string can be used with 2 values: ​​ru and en

Returns:
After successful registration, you will receive a record: “Pass:password”, where password - new password for client in userarea.

ResetPassword

Description :
Reset password for user you registered via API

Inputs:
string login - your email address to login at userarea.zennolab.com
string password - md5 hash of your password at userarea.zennolab.com
string email - email of your customer

Returns:
After successful operation, you will receive a record: “Pass:password”, where password - new password for client in userarea.

Description :
Returns the direct download link for your client's ZennoBox

Inputs:
string login - your email address to login at userarea.zennolab.com
string password - md5 hash of your password at userarea.zennolab.com
string customerEmail - customer's email

Returns:
Direct link

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

where * indicates the latest version and ZennoBox' langauge which is available for your client.

CreateBot

Description:
Register new bot in user area. To upload it please use UploadBotContent method.

Inputs:
string login - your email address to login at userarea.zennolab.com
string password - md5 hash of your password at userarea.zennolab.com
string botName - name of bot in user area.
string fileName - name of file which will be created at client's PC after sale.
string comment - your comment.

Returns:
One of the following lines:
Ok:{bot id} - operation was successful, id of registered bot returned.
Exception - internal error occurred, if the problem persists, you should contact Zennolab's customer support.
NoSuchUser - you have specified invalid authorization data.

UploadBotContent

Description:
Upload new bot to user area.

Inputs:
string login - your email address to login at userarea.zennolab.com
string password - md5 hash of your password at userarea.zennolab.com
int botId - id of bot in user area, you can get швы ща you bots via GetBotList method.
string botContent - content of bot, converted to base64 string.
string comment - your comment

Returns:
One of the following lines:
Ok - operation completed successfully.
Exception - internal error occurred, if the problem persists, you should contact Zennolab's customer support.
NoSuchBot - you have specified incorrect bot's id.
NoSuchUser - you have specified invalid authorization data.

en/devlicense/api.txt · Last modified: 2016/11/16 13:16 by adminsama