API functions to automate the sale of your projects
- Stanislav N. (Unlicensed)
- ZL Support
Please read the Terms of Use for Materials on ZennoLab
The WebService API is located at: https://userarea.zennolab.com/BotStore.asmx
You can upload your projects at: https://userarea.zennolab.com/en/userarea/Bots.aspx
How to connect WebService to ASP.NET projects 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).
The following functions are currently available:
Getting information about bots loaded in UserArea: GetBotList
Working with bot sales: GetSales, SaleBots, RefundSale, ChangeSubscription
Working with users: GetCurrentCustomerEmail, RegisterCustomer, ResetPassword, GetCustomerBoxLink
Bot management: CreateBot, UploadBotContent
GetBotList
Description :
Gets a list of bots registered in the UserArea.
Accepts :
string login - Your e-mail to enter userarea.zennolab.com
string password - md5 hash of your password for userarea.zennolab.com
Returns :
Array of BotInfo objects
public class BotInfo
{
// unique identifier of the bot
public int Id;
// bot name
public string Name;
// file name
public string FileName;
// when created
public DateTime Created;
// when was last updated
public DateTime Modified;
// your comment
public string Comment;
// size in bytes
public int Size;
}GetSales
Description :
Receives a list of your sales, sales can be requested for a specific client by specifying his e-mail.
Accepts :
string login - Your e-mail to enter userarea.zennolab.com
string password - md5 hash of your password for userarea.zennolab.com
string filterByCustomerEmail - e-mail of the user who was sold to, if you specify an empty string, you will get the entire list of sales
Returns :
Array of SaleInfo objects:
public class SaleInfo
{
// unique identifier of the sale
public int Id;
// Date of sale
public DateTime SaleDateTime;
// customer email
public string CustomerEmail;
// bots id separated by commas
public string Bots;
// was there a Refund for this sale
public bool HasRefund;
// sale is a subscription or not
public bool IsSubscription;
// when the subscription ends
public DateTime? SubscriptionDueDate;
// in which products the project can work
// 1 - only in ZennoBox, 2 - only in ZennoPoster, 3 - in ZennoBox and ZennoPoster
public int ForProducts;
}SaleBots
Description :
Sells the specified bots to the specified buyer.
Accepts :
string login - Your e-mail to enter userarea.zennolab.com
string password - md5 hash of your password for userarea.zennolab.com
string customerEmail - customer e-mail
string ids - unique identifiers of your bots, if you need to sell several bots at once, you should specify id separated by commas
bool isSubscription - true if this is a subscription and false if it is a regular sale
int subscriptionDaysCount - the number of days of subscription, if this is a regular sale, then you should specify 0
int forProducts - in which products the project can work 1 - only in ZennoBox, 2 - only in ZennoPoster, 3 - in ZennoBox and ZennoPoster
Returns :
int id of the sale
RefundSale
Description :
Recalls the sale. The bot becomes inoperable for the client.
Accepts :
string login - Your e-mail to enter userarea.zennolab.com
string password - md5 hash of your password for userarea.zennolab.com
int saleId - sale id
Returns :
One of the following lines:
Ok - the operation was successful.
Exception - an internal error has occurred, if the error repeats, you should contact ZennoLab support.
NoSuchSale - You entered an invalid sale id.
NoSuchUser - You specified incorrect authorization data.
RefundTimeout - you are trying to return money for a sale that was made before the acquisition of the Developer license, you can automatically do this only within 30 days, if you need to make a recall of the sale, after 30 days, you can do this only through the interface in the administrative panel, ZennoLab commission will not be refunded.
ChangeSubscription
Description :
Modifies subscription options.
Accepts :
string login - Your e-mail to enter userarea.zennolab.com
string password - md5 hash of your password for userarea.zennolab.com
int saleId - sale id
int addDays - the number of days to renew the subscription, you can specify a negative number, then the subscription period will be reduced
Returns :
One of the following lines:
Ok - the operation was successful.
Exception - an internal error has occurred, if the error persists, you should contact ZennoLab support.
NoSuchSale - You entered an invalid sale id.
NoSuchUser - You specified incorrect authorization data.
GetCurrentCustomerEmail
Description :
The function allows you to check whether a user is already registered with us or not.
Accepts :
string login - Your e-mail to enter userarea.zennolab.com
string password - md5 hash of your password for userarea.zennolab.com
string customerEmail - your customer's e-mail
Returns :
Returns the actual (the user could have changed the registration e-mail) user's e-mail. If the user is not registered, then you will receive a reply nosuchuser@zennolab.com
RegisterCustomer
Description :
Registers the user in the ZennoLab personal account.
Accepts :
string login - Your e-mail to enter userarea.zennolab.com
string password - md5 hash of your password for userarea.zennolab.com
string email - your client's e-mail
string lang - the language of your client, can take 2 values ru and en
Returns :
Upon successful registration, you will get a record of the form: "Pass: password", where password is the password of the registered user from the personal account.
ResetPassword
Description :
Allows you to change the ZennoLab user password if you registered it via the API.
Accepts :
string login - Your e-mail to enter userarea.zennolab.com
string password - md5 hash of your password for userarea.zennolab.com
string email - your client's e-mail
Returns :
If the operation is successful, you will get a record of the form: "Pass: password", where password is the user's password from the personal account.
GetCustomerBoxLink
Description :
Returns a direct ZennoBox download link for your client.
Accepts :
string login - Your e-mail to enter userarea.zennolab.com
string password - md5 hash of your password for userarea.zennolab.com
string customerEmail - your customer's e-mail
Returns :
Link like:
https://userarea-us.zennolab.com/download/ZennoBox*.exewhere instead of * the latest version and language of ZennoBox available for your client is indicated.
CreateBot
Description :
Registers a new bot in the admin panel, in order to upload the bot after registration, use UploadBotContent.
Accepts :
string login - Your e-mail to enter userarea.zennolab.com
string password - md5 hash of your password for userarea.zennolab.com
string botName - the name of the bot in the admin area
string fileName - the name of the project file that will be created at the client
string comment - Your comment
Returns :
One of the following lines:
Ok: {bot id} - the operation was successful, the id of the created bot is returned.
Exception - an internal error has occurred, if the error persists, you should contact ZennoLab support.
NoSuchUser - You specified incorrect authorization data.
UploadBotContent
Description :
Uploads new bot content to the admin panel.
Accepts :
string login - Your e-mail to enter userarea.zennolab.com
string password - md5 hash of your password for userarea.zennolab.com
int botId - bot id in the admin panel, the id of your bots can be found using the GetBotList function
string botContent - project content converted to base64 string
string comment - Your comment
Returns :
One of the following lines:
Ok - the operation was successful.
Exception - an internal error has occurred, if the error persists, you should contact ZennoLab support.
NoSuchBot - You entered an invalid bot id.
NoSuchUser - You specified incorrect authorization data.