Jump to content
  • Sky
  • Blueberry
  • Slate
  • Blackcurrant
  • Watermelon
  • Strawberry
  • Orange
  • Banana
  • Apple
  • Emerald
  • Chocolate
  • Charcoal
bregsm

dc-unlocker API

Recommended Posts

Hello,

Please add dc-unlocker.com API. If you need any other information, let me know.

Full Details Here:

 

Uses

  • Activate Vygis and Rocker dongles.
  • Add credits to Vygis, Rocker, Infinity dongles.
  • Receive information about dongle: activation status, activation date, block status, credits remaining, support status, active features.
  • Create new user or reseller.
  • Add / remove credits from user.
  • Check if user name is valid and unique in system.
  • Check and renew user's timed license.
  • Check remaining credits of API user, dongle or another user.
  • Extend dongle support period.
  • Activate dongle features.
  • Get information about active dongle features and activations, available support and user timed licenses.

Downloads

This is the only place to download DC-unlocker API

Latest version: 2.02

Others:

Installation

  1. Server must have PHP support and openssl extension for message encryption.
  2. Copy files to server.
  3. Include DcUnlockerAPI.class.php in to your code.
  4. See examples for available methods and how to use them.

Examples

These examples only valid for API version 2.02 !

You can enable test mode for an action with function testModeOn(). No changes will be made to credits, users, dongles but results will be returned. See examples how to use this function to enable test mode.

Change Log

2.02
  • New users can be created with timed licenses already activated.
  • Information about available support (id, price and name) is returned by getDongleSupportList() function.
  • All available activations (including pricing) are returned by getDongleActivationList() function.
2.00
  • Dongle feature activation.
  • All available dongle features are returned by getFeaturesList() function.
  • Activated dongle features are returned by getDongleActiveFeatures() or getAllInfo() functions.
  • Timed licenses for users.
  • All available user timed licenses are returned by getTimedLicenseList() function.
  • User's timed license status is returned by getTimedLicenseStatus() function.
  • Fix: allow actions to be called one after another without reinitializing API object.
  • Fix: "DIDN'T FOUND RECORD" error message (code 202) changed to "USER NOT FOUND"
  • Fix: "USER IS ALREADY BLOCKED" error message (code 208) changed to "USER IS BLOCKED"
  • Fix: new dongle support status is returned after renewal.
  • Removed config.php file. User name and password now passed directly to API class constructor and custom public.key path provided by DCU_API_PUBLIC_KEY define.
  • Removed deprecated function getUserWithCreditsList() .
  • New error codes: 215, 216, 217, 218, 219, 264, 265, 323, 324, 325 (see "Error codes" for explanation).
  • Servers unix timestamp is returned in the response.
  • DC-unlocker dongles can use serial number in integer form instead of hex.
  • Vygis/Rocker/Infinity dongle activation function activateDongle() with type auto detection.
  • New Reseller type users can be created.
  • Limit credit transfer from user to two weeks after user is created.
  • Live demo of the API is now available. Check examples for links to demo scripts.
1.09
  • getAllInfo() now also returns dongle support status and expiration time.
  • Added getDongleSupportStatus() function. Returns dongle support status and/or expiration time. See Get dongle support statusexample.
  • Added renewDongleSupport() function. Extends dongle support period. See Renew dongle support example.
  • Removed legacy (1.07 and older) code support.
  • Modified PUBLIC_KEY config setting to support relative paths.
1.08
  • added new error code: 260. Dongle S/N was not found
  • added new error code: 259. Dongle needs to be activated
  • Transfer credits to non activated dongle is forbidden. Returns 259 error code (see above)
  • Added function checkDongleSN() - look up dongle s/n in database (see example for more info)
1.07
  • 10 000 credits transfer limit with one operation set
  • Function createNewUser changed. Old function required 4 variables: username, password, email, credits. New function requires only two variables: username, credits. function createNewUser($userName, $credits)
    Removed email, and password variables.
    Password will be generated and will be found in response message\'s array [new_user_pass] key value. 
    For more info check Create new user example

Error Codes

202
Entered user's name was not found
203
Not enough credits for operation
206
Api user can't check entered user's data
You can only check user data of your account and users/dongles you created
207
User name exists
Entered user name exists in system. You can not create duplicate user name
208
User is already blocked
Trying to block already blocked user
209
Entered user name is reserved in system.
You can not create user with reserved user name
211
Too many incorrect login attempts (3 or more per day)
212
Maximum transfer credits limit reached
213
API user login incorrect
215
API user does not have permission to use timed licenses
216
Timed license id is invalid
217
Failed to renew timed license
218
Failed to create a new user
219
API user's software does not match with client user's software
252
Dongle already activated 
You are trying to activate already activated dongle
255
Dongle serial number and type mismatch
You are trying to activate dongle with different dongle activation API command.
For example trying to activate Vygis dongle with function activateRockerDongle()
257
API user can not activate specified dongle type
258
Dongle is blocked
259
Dongle needs to be activated
260
Dongle S/N not found
262
Dongle must have at least one unlock operation done
264
Failed to set dongle feature
265
Dongle feature is already set
301
Invalid IP address
302
Invalid dongle serial number
Vygis dongle serial number length is 8
Rocker dongle serial number length is 16
Infinity dongle serial number length is 10
S/n is from 0-9 A-F character range
313
Incorrect credit amount
Must be integer number between 1-9999
317
Invalid entered user name
Valid user name is between length 5-16, can have characters from (a-zA-Z0-9_.-), except reserved names for dongle serial numbers (dongle s/n)
check your inputs
319
API user is not a creator or activator
322
This action is not allowed for special users
323
User is too old for this action
324
Invalid dongle feature
325
Reseller must have at least 200 credits (new user or recipient)
 
Best Regards
unlock.bregsm.com

Share this post


Link to post
Share on other sites
26 minutes ago, bregsm said:

Hello,

Please add dc-unlocker.com API. If you need any other information, let me know.

Full Details Here:

 

Uses

  • Activate Vygis and Rocker dongles.
  • Add credits to Vygis, Rocker, Infinity dongles.
  • Receive information about dongle: activation status, activation date, block status, credits remaining, support status, active features.
  • Create new user or reseller.
  • Add / remove credits from user.
  • Check if user name is valid and unique in system.
  • Check and renew user's timed license.
  • Check remaining credits of API user, dongle or another user.
  • Extend dongle support period.
  • Activate dongle features.
  • Get information about active dongle features and activations, available support and user timed licenses.

Downloads

This is the only place to download DC-unlocker API

Latest version: 2.02

Others:

Installation

  1. Server must have PHP support and openssl extension for message encryption.
  2. Copy files to server.
  3. Include DcUnlockerAPI.class.php in to your code.
  4. See examples for available methods and how to use them.

Examples

These examples only valid for API version 2.02 !

You can enable test mode for an action with function testModeOn(). No changes will be made to credits, users, dongles but results will be returned. See examples how to use this function to enable test mode.

Change Log

2.02
  • New users can be created with timed licenses already activated.
  • Information about available support (id, price and name) is returned by getDongleSupportList() function.
  • All available activations (including pricing) are returned by getDongleActivationList() function.
2.00
  • Dongle feature activation.
  • All available dongle features are returned by getFeaturesList() function.
  • Activated dongle features are returned by getDongleActiveFeatures() or getAllInfo() functions.
  • Timed licenses for users.
  • All available user timed licenses are returned by getTimedLicenseList() function.
  • User's timed license status is returned by getTimedLicenseStatus() function.
  • Fix: allow actions to be called one after another without reinitializing API object.
  • Fix: "DIDN'T FOUND RECORD" error message (code 202) changed to "USER NOT FOUND"
  • Fix: "USER IS ALREADY BLOCKED" error message (code 208) changed to "USER IS BLOCKED"
  • Fix: new dongle support status is returned after renewal.
  • Removed config.php file. User name and password now passed directly to API class constructor and custom public.key path provided by DCU_API_PUBLIC_KEY define.
  • Removed deprecated function getUserWithCreditsList() .
  • New error codes: 215, 216, 217, 218, 219, 264, 265, 323, 324, 325 (see "Error codes" for explanation).
  • Servers unix timestamp is returned in the response.
  • DC-unlocker dongles can use serial number in integer form instead of hex.
  • Vygis/Rocker/Infinity dongle activation function activateDongle() with type auto detection.
  • New Reseller type users can be created.
  • Limit credit transfer from user to two weeks after user is created.
  • Live demo of the API is now available. Check examples for links to demo scripts.
1.09
  • getAllInfo() now also returns dongle support status and expiration time.
  • Added getDongleSupportStatus() function. Returns dongle support status and/or expiration time. See Get dongle support statusexample.
  • Added renewDongleSupport() function. Extends dongle support period. See Renew dongle support example.
  • Removed legacy (1.07 and older) code support.
  • Modified PUBLIC_KEY config setting to support relative paths.
1.08
  • added new error code: 260. Dongle S/N was not found
  • added new error code: 259. Dongle needs to be activated
  • Transfer credits to non activated dongle is forbidden. Returns 259 error code (see above)
  • Added function checkDongleSN() - look up dongle s/n in database (see example for more info)
1.07
  • 10 000 credits transfer limit with one operation set
  • Function createNewUser changed. Old function required 4 variables: username, password, email, credits. New function requires only two variables: username, credits. function createNewUser($userName, $credits)
    Removed email, and password variables.
    Password will be generated and will be found in response message\'s array [new_user_pass] key value. 
    For more info check Create new user example

Error Codes

202
Entered user's name was not found
203
Not enough credits for operation
206
Api user can't check entered user's data
You can only check user data of your account and users/dongles you created
207
User name exists
Entered user name exists in system. You can not create duplicate user name
208
User is already blocked
Trying to block already blocked user
209
Entered user name is reserved in system.
You can not create user with reserved user name
211
Too many incorrect login attempts (3 or more per day)
212
Maximum transfer credits limit reached
213
API user login incorrect
215
API user does not have permission to use timed licenses
216
Timed license id is invalid
217
Failed to renew timed license
218
Failed to create a new user
219
API user's software does not match with client user's software
252
Dongle already activated 
You are trying to activate already activated dongle
255
Dongle serial number and type mismatch
You are trying to activate dongle with different dongle activation API command.
For example trying to activate Vygis dongle with function activateRockerDongle()
257
API user can not activate specified dongle type
258
Dongle is blocked
259
Dongle needs to be activated
260
Dongle S/N not found
262
Dongle must have at least one unlock operation done
264
Failed to set dongle feature
265
Dongle feature is already set
301
Invalid IP address
302
Invalid dongle serial number
Vygis dongle serial number length is 8
Rocker dongle serial number length is 16
Infinity dongle serial number length is 10
S/n is from 0-9 A-F character range
313
Incorrect credit amount
Must be integer number between 1-9999
317
Invalid entered user name
Valid user name is between length 5-16, can have characters from (a-zA-Z0-9_.-), except reserved names for dongle serial numbers (dongle s/n)
check your inputs
319
API user is not a creator or activator
322
This action is not allowed for special users
323
User is too old for this action
324
Invalid dongle feature
325
Reseller must have at least 200 credits (new user or recipient)
 
Best Regards
unlock.bregsm.com

Thank you for detailed request, can you please let us know which kind of services they offer? IMEI, File, Server or something else? Also can you please provide test credentials by PM to use in integration process?

Share this post


Link to post
Share on other sites

Create an account or sign in to comment

You need to be a member in order to leave a comment

Create an account

Sign up for a new account in our community. It's easy!

Register a new account

Sign in

Already have an account? Sign in here.

Sign In Now

×

Important Information

By using this site, you agree to our Terms of Use.