limelm.prod.createVers

Create a new version in a product.

Arguments

api_key (Required)

Your API application key. Your api key is available on your settings page.

prod_id (Required)

The id of the product you'll be creating this new version in. You can get the product ID by examining the URL in your browser. For instance, from the URL https://wyday.com/limelm/product/42/ you can see the product ID is 42. Also, the product id is returned when you call the limelm.prod.getAll web API function.

name (Required)

The name of the version. Maximum 255 characters.

trial_length (Optional)

How long you want the timed trial to last for new customers of this product version. Set to “0” for no trial. The default for trial_length is 0.

where_is_pkey (Required)

A short description of where the customer can find their product key. This is used in the TurboActivate wizard. Maximum 2048 characters.

buy_link (Required)

Where your customers can purchase your software. This link used in the TurboActivate wizard. Maximum 2048 characters.

Example Response

The method returns the product version id that has been created.

<version id="42"/>

Error Codes

100: Invalid API Key

The API key passed was not valid or has expired.

101: Method "xxx" not found

The requested method was not found.

164: An API key must be used by X devices. Configurable in your settings.

You can only use an API key from X devices. You can set the exact number on your settings page. If you need to use the web API from multiple servers then create another user. You can also temporarily reset this message by logging into the account for which the API key is created and resetting the last used IP address on your settings page.

168: LimeLM web API only supports POST over HTTPS.

All web API functions must be used over HTTPS using POST. Described in the web API overview.

108: The product id is missing.

The product id was not specified.

109: The product doesn't exist or you don't have access to it.

Check to make sure you have access to the product id you've passed in.

118: Your account is in dormant mode. Re-enable your account.

You cannot generate product keys when your account is in dormant mode. Re-enable your account and you will no longer get this error.

125: The "name" parameter must exist and it must be less than 255 characters long.

Make sure your version name is greater than 0 characters and less than 255.

142: Service currently unavailable

The requested service is temporarily unavailable.

166: You do not have permission to create, remove, or edit products and versions. Contact your account administrator(s).

You need to ask an admin to give you permission to create / edit / remove products and versions.

170: You must enter where to find the product key.

You must supply the "where_is_pkey" parameter even if you're not using the TurboActivate wizard.

171: You must enter the purchase site for this version of your product.

You must supply the "buy_link" parameter even if you're not using the TurboActivate wizard.

172: Enter a valid url (e.g. https://example.com/buy/ )

The "buy_link" parameter must be a valid URL.

169: This version name already exists in this product.

Even version in a product must have a unique name.