PHP Integration

First, let's get your SECRET_KEY. Go to config.php of Blackout and look for the text: define('SECRET_KEY', 'XXXXXXXXXXXXX'); and copy it.

Now let's verify what level of security you are using. Go to config.php and look for define('API_SECURITY', 0); check between 0, 1, and 2. If it is 1, you only need the secret_key. If it is 2, you need to generate a request code on your dashboard. If it is 3, you need to get the SECRET_KEY of your software account and verify that you have the permission dbb.admin.request.validation or dbb.*.

If you have everything, let's proceed to write the code. Note that this applies to all other code.

Create a License

Use this PHP example to generate a license via API requests. Requirements:

CLIENT (The client ID. This can only be the DISCORD_ID or the SOFTWARE_ID of the registered user.)
PRODUCT (You need to verify which product you want this to be for, remember to check products to see if it exists and what the ID_name is.)
EXPIRE (This only applies in DAYS. You can put a number between 1 to greater.)
MAXIPS (This is to know how many MAX IPS this license wants to have. It can be 1 or more.)
BOUND (Force this key to use the PRODUCT.)
CUSTOM_ADDONS (This must be together and separated by # for example: unlimited#dbb#debugg etc. [No limit.]

<?php
$domain = 'license.devbybit.com';
$secret = 'PUT_YOUR_SECRET_KEY';
$type = 'create';
$table = 'license';
$client = '623308343582130187'; // ID OF USER.
$product = 'Blackout';
$expire = '15'; // Optional, Default 30 days.
$maxips = '10'; // Optional, Default 5.
$bound = '1'; // Optional, Default 0.
$custom_addons = 'addon1#addon2#addon3#addon4'; // Optional

$params = [
    'secret' => $secret,
    'type' => $type,
    'table' => $table,
    'client' => $client,
    'product' => $product,
    'expire' => $expire,
    'maxips' => $maxips,
    'bound' => $bound,
    'custom_addons' => $custom_addons,
];

$url = "https://" . $domain . "/api.php?" . http_build_query($params);

$response = file_get_contents($url);

if ($response === false) {
    echo "Error...";
    exit;
}

$data = json_decode($response, true);

if ($data['valid']) {
    echo "Success!";
    var_dump($data); 
} else {
    echo "Incorrect.";
    var_dump($data); 
}
?>

Perfect! It seems that everything went correctly. Now it remains to adjust the code to your liking.

Create a Product

Use this PHP example to generate a product via API requests. Requirements:

NAME (Form of specifying the software name on the site for preview.)
ID_NAME (The identifier of the plugin name. This is mandatory for successful verification.)
DESCRIPTION (It is optional, but you can leave a description up to 75 letters.)
PRICE (It is optional. You can set a price to calculate your earnings through the generated keys.)
VERSION (It is optional. This option can be used to make UPDATES and keep control of the obligation to use the latest versions.)
TEBEX (It is optional. It only works if you have tebex enabled. Otherwise, it doesn't matter what you put, it will be NULL.)

<?php
$domain = 'license.devbybit.com';
$secret = 'PUT_YOUR_SECRET_KEY';
$type = 'create';
$table = 'product';
$name = 'Blackout';
$id_name = 'Blackout-v1.5.3-BETA';
$description = ''; // Optional
$price = '5.50'; // Optional, Default 0.00.
$version = '1.5.3-BETA'; // Optional, Default 1.0.
$tebex = 'addon1#addon2#addon3#addon4'; // Optional [Require tebex active.]

$params = [
    'secret' => $secret,
    'type' => $type,
    'table' => $table,
    'name' => $name,
    'id_name' => $id_name,
    'description' => $description,
    'price' => $price,
    'version' => $version,
    'tebex' => $tebex,
];

$url = "https://" . $domain . "/api.php?" . http_build_query($params);

$response = file_get_contents($url);

if ($response === false) {
    echo "Error...";
    exit;
}

$data = json_decode($response, true);

if ($data['valid']) {
    echo "Success!";
    var_dump($data); 
} else {
    echo "Incorrect.";
    var_dump($data); 
}
?>

Perfect! It seems that everything went correctly. Now it remains to adjust the code to your liking.

Create a User

Use this PHP example to generate a user via API requests. Requirements:

USERNAME (The username. This is a subname for the software.)
PASSWORD (If you put a password, you have to encode it in MD5. Only in version 1.5.3)
EMAIL (The user's email. It is mandatory.)
UDID (The user's Discord ID. It must be DISCORD_ID obligatorily.)
AVATAR (The URL of the user's avatar. It is mandatory.)

<?php
$domain = 'license.devbybit.com';
$secret = 'PUT_YOUR_SECRET_KEY';
$type = 'create';
$table = 'user';
$name = 'Vuhp'; // Name for this user.
$password = ''; // Optional or place in md5 codif.
$email = 'juanmpanizzino@gmail.com';
$udid = '623308343582130187'; // Discord user ID.
$avatar = ''; // Require image link of discord user.

$params = [
    'secret' => $secret,
    'type' => $type,
    'table' => $table,
    'username' => $name,
    'password' => $password,
    'email' => $email,
    'udid' => $udid,
    'avatar' => $avatar,
];

$url = "https://" . $domain . "/api.php?" . http_build_query($params);

$response = file_get_contents($url);

if ($response === false) {
    echo "Error...";
    exit;
}

$data = json_decode($response, true);

if ($data['valid']) {
    echo "Success!";
    var_dump($data); 
} else {
    echo "Incorrect.";
    var_dump($data); 
}
?>

Perfect! It seems that everything went correctly. Now it remains to adjust the code to your liking.

Create a Group

Use this PHP example to generate a group via API requests. Requirements:

NAME (The name for the group. Mandatory.)
COLOR (It is optional. You can put a color only with #028000 or any HEX code of your preference. It is mandatory to use HEX for others and must carry the # at the beginning.)

<?php
$domain = 'license.devbybit.com';
$secret = 'PUT_YOUR_SECRET_KEY';
$type = 'create';
$table = 'group';
$name = 'Developer';
$color = '#028000';

$params = [
    'secret' => $secret,
    'type' => $type,
    'table' => $table,
    'name' => $name,
    'color' => $color,
];

$url = "https://" . $domain . "/api.php?" . http_build_query($params);

$response = file_get_contents($url);

if ($response === false) {
    echo "Error...";
    exit;
}

$data = json_decode($response, true);

if ($data['valid']) {
    echo "Success!";
    var_dump($data); 
} else {
    echo "Incorrect.";
    var_dump($data); 
}
?>

Perfect! It seems that everything went correctly. Now it remains to adjust the code to your liking.

Create a Group Permission

Use this PHP example to generate a permission via API requests. Note that creating a group is the first step to obtain the ID of it. After obtaining the ID, we will place it in group = ''. Requirements:

GROUP (The ID of the group.)
PERMISSION (The permission to insert.)

<?php
$domain = 'license.devbybit.com';
$secret = 'PUT_YOUR_SECRET_KEY';
$type = 'create';
$table = 'group_permission';
$group = '6'; // ID of the Group.
$permission = 'dbb.*';

$params = [
    'secret' => $secret,
    'type' => $type,
    'table' => $table,
    'group' => $group, // MANDATORY
    'permission' => $permission, // MANDATORY
];

$url = "https://" . $domain . "/api.php?" . http_build_query($params);

$response = file_get_contents($url);

if ($response === false) {
    echo "Error...";
    exit;
}

$data = json_decode($response, true);

if ($data['valid']) {
    echo "Success!";
    var_dump($data); 
} else {
    echo "Incorrect.";
    var_dump($data); 
}
?>

Perfect! It seems that everything went correctly. Now it remains to adjust the code to your liking.

Create a Group User

Use this PHP example to insert a user via API requests. Note that creating a group is the first step to obtain the ID of it. After obtaining the ID, we will place it in group = ''. Requirements:

GROUP (The ID of the group.)
USER (The ID of the user.)

<?php
$domain = 'license.devbybit.com';
$secret = 'PUT_YOUR_SECRET_KEY';
$type = 'create';
$table = 'group_user';
$group = '6'; // ID of the Group.
$user = '1'; // ID of the user in software.

$params = [
    'secret' => $secret,
    'type' => $type,
    'table' => $table,
    'group' => $group, // MANDATORY
    'user' => $user, // MANDATORY
];

$url = "https://" . $domain . "/api.php?" . http_build_query($params);

$response = file_get_contents($url);

if ($response === false) {
    echo "Error...";
    exit;
}

$data = json_decode($response, true);

if ($data['valid']) {
    echo "Success!";
    var_dump($data); 
} else {
    echo "Incorrect.";
    var_dump($data); 
}
?>

Perfect! It seems that everything went correctly. Now it remains to adjust the code to your liking.

Create a Code

Use this PHP example to insert a user via API requests. This only works for LICENSE and ADDONS codes. Request codes will have to be generated manually. Requirements:

LICENSE OPTION
- SUBTYPE (Option of the code [license / addons] In this case 'license'.)
- PRODUCT (The name of the product.)
- MAXIPS (The maximum IPs for the license.)
- EXPIRE (Expiration in days, place a number greater than 1.)
ADDONS OPTION
- SUBTYPE (Option of the code [license / addons] In this case 'addons'.)
- ADDONS (It is mandatory and all must be placed in order and without spaces. For example: option1#option2#option.3#optio.ns4 etc.)

<?php
$domain = 'license.devbybit.com';
$secret = 'PUT_YOUR_SECRET_KEY';
$type = 'create';
$table = 'code';
$subtype = 'license';
$product = 'Blackout';
$maxips = '15';
$expire = '366';
$addons = 'Options1#Unlimited#option..23#Option/15';

$params = [
    'secret' => $secret,
    'type' => $type,
    'table' => $table,
    'subtype' => $subtype,
    'product' => $product,
    'maxips' => $maxips,
    'expire' => $expire,
    // 'addons' => $addons, // Use this? Remove: product, maxips & expire.
];

$url = "https://" . $domain . "/api.php?" . http_build_query($params);

$response = file_get_contents($url);

if ($response === false) {
    echo "Error...";
    exit;
}

$data = json_decode($response, true);

if ($data['valid']) {
    echo "Success!";
    var_dump($data); 
} else {
    echo "Incorrect.";
    var_dump($data); 
}
?>

Perfect! It seems that everything went correctly. Now it remains to adjust the code to your liking.

I hope this helps with your project. Keep in mind that these are example codes and are not solid bases well done. But it is an example to learn the functionality and adapt your codes.

Done.

Regards, juan panizzino📀

PreviousAPI Actions Create NextJava Integration

Last updated 5 months ago