SoftLocker.net - Support Database - Advanced: User Automation

Support Database

Subject:

Advanced: User Automation

Category:

Keywords:

automation, integration, automate, automatically

Article:

SoftLocker user management can be fully automated by your web server by sending information to:

http://www.softlocker.net/automate.asp

You will need the following information:

Your customer ID, found on your My Account page

Your customer PIN, found on your My Account page

You must then send the following information to SoftLocker via a POST or GET request:

Name	Variable	Possible Values
URL: http://www.softlocker.net/automate.asp
Customer ID	cust_id	The ID found on your My Account page
Customer PIN	cust_pin	The PIN found on your My Account page
Transaction*	txn_id	The transaction number sent when the account was created
Email*	user_email	The email or username you wish to work with
Product ID*	prod_id	The product ID from the Product list in the SoftLocker client
Action	action	One of the values from the Action Chart below
Additional Data	data	An expiration date in the format YYYY-MM-DD, or the word "NEVER" only used for the EXPIRE action

*You must provide either the unique Transaction number for the user, or the Email and Product ID combination for the user; preferably all three items should be provided to be as accurate as possible in looking up the registration. The transaction number is preferred but not necessary. See adding a transaction number for more information.

Action	Description
RESET	Allows the registration code to be used on a new computer (Single-computer registrations only)
REMOVE	Disables and removes the registration
ENABLE	Enables the registration
DISABLE	Disables the registration
MULTI	Changes the registration to multi-computer
SINGLE	Changes the registration to single-computer
EXPIRE	Changes the expiration date. Send "NEVER" in the "data" variable to remove an expiration. Send a date in the format YYYY-MM-DD in the "data" variable set an expiration. The "data" variable is not used for other actions.

You can "hit" the automation URL with a querystring, or post form data. For example, a querystring:

http://www.softlocker.net/automate.asp?cust_id=1&cust_pin=1234&txn=19283029383&user_email=somedude@someplace.com&prod_id=394&Action=ENABLE

http://www.softlocker.net/automate.asp?cust_id=1&cust_pin=1234&txn=19283029383&user_email=somedude@someplace.com&prod_id=394&Action=DISABLE

http://www.softlocker.net/automate.asp?cust_id=1&cust_pin=1234&txn=19283029383&user_email=somedude@someplace.com&prod_id=394&Action=EXPIRE&data=2010/04/08

http://www.softlocker.net/automate.asp?cust_id=1&cust_pin=1234&txn=19283029383&user_email=somedude@someplace.com&prod_id=394&Action=EXPIRE&data=Never

You will receive a response in the following format:

[SUCCESS/FAILURE]|[REASON]|

For example:

Success|Success|
Failure|Could not find a matching record or action|
Failure|Account Inactive|
Failure|Bad Password|

Home - SoftLocker.net Client - SoftLocker ListBuilder - Tutorials - Support - Privacy - Affiliates