Laravel LogicBoxes API

A Laravel package for interacting with the LogicBoxes / ResellerClub HTTP API.

Supports both the live (httpapi.com) and test (test.httpapi.com) environments.

---

Requirements

• PHP 8.0+
• Laravel 9+
• A LogicBoxes / ResellerClub reseller account

---

Installation

The package is included as a local path repository in LiBilling. No separate composer require is needed inside the monorepo. For standalone use:

composer require lithiumhosting/laravel-logicboxes-api

Publish the config file:

php artisan vendor:publish --provider="LithiumHosting\LogicBoxesApi\LogicBoxesApiServiceProvider" --tag="config"

This creates config/logicboxes-api.php.

---

Configuration

Set your credentials in .env:

LOGICBOXES_RESELLER_ID=123456
LOGICBOXES_API_KEY=your-api-key-here
LOGICBOXES_DEMO=false

Variable	Description
LOGICBOXES_RESELLER_ID	Your numeric reseller ID from the control panel
LOGICBOXES_API_KEY	Your API key generated in the control panel
LOGICBOXES_DEMO	Set to true to use the test sandbox (test.httpapi.com)

The published config/logicboxes-api.php maps these values:

return [
    'resellerid' => env('LOGICBOXES_RESELLER_ID'),
    'apikey'     => env('LOGICBOXES_API_KEY'),
    'demo'       => env('LOGICBOXES_DEMO', false),
];

---

Getting Your Reseller ID and API Key

1. Log in to the ResellerClub / LogicBoxes Control Panel

Go to https://manage.resellerclub.com (or your branded URL if you have one).

2. Find Your Reseller ID

Your reseller ID is visible in the top-right corner of the control panel after logging in, or under:

Settings → Personal Information → Reseller ID

It is a numeric value (e.g., 123456).

3. Generate an API Key

Navigate to:

Settings → API (or Manage → API Access)

1. Click Generate New Key (or Add New IP if IP restriction is enabled).
2. Optionally restrict the key to specific IP addresses for security.
3. Copy the key immediately, it is only shown once.

Security tip: Restrict your API key to your server's IP addresses. This prevents the key from being usable if it is ever leaked.

4. Test Environment (Sandbox)

ResellerClub provides a free sandbox for testing without real transactions:

• Control panel: https://test.httpapi.com (or https://demo.myorderbox.com)
• API endpoint: https://test.httpapi.com/api/

Register a free test reseller account at https://demo.myorderbox.com. Test accounts have separate credentials from your production account.

Set LOGICBOXES_DEMO=true in your .env to use the sandbox endpoint.

---

Usage

The package registers a singleton bound to logicboxesapi. You can resolve it via the facade, the service container, or direct instantiation.

Making a Raw API Call

use LithiumHosting\LogicBoxesApi\LogicBoxesApiFacade as LogicBoxesApi;

// GET request, fetch legal agreements
$result = LogicBoxesApi::call('legal-agreements', 'commons', [
    'type' => 'customermasteragreement',
], 'GET');

// POST request (default)
$result = LogicBoxesApi::call('signup', 'customers', $customerData);

The call() signature is:

public function call(string $command, string $type, array $params, string $method = 'POST'): array

The URL resolves to: {baseUrl}/{type}/{command}.json

Check Domain Availability

// Check a single domain
$result = LogicBoxesApi::checkDomainAvailability('example', ['com', 'net', 'org']);

// $result is an associative array:
// [
//   'example.com' => 'available',
//   'example.net' => 'regthroughothers',
//   'example.org' => 'regthroughus',
// ]

Status values returned by the API:

Status	Meaning
available	Domain is available for registration
regthroughus	Registered through your reseller account
regthroughothers	Registered through another registrar
unknown	Status could not be determined

Get Domain Suggestions

$suggestions = LogicBoxesApi::getDomainSuggestions('mystore', ['com', 'net'], exact: true);

Customer Management

// Resolve a customer ID (creates the customer if not found)
$customerId = LogicBoxesApi::get_customer_id($user, $account);

---

API Reference

The full LogicBoxes HTTP API documentation is available at:

• API Guide: https://manage.logicboxes.com/kb/node/744
• Domain APIs: https://manage.logicboxes.com/kb/node/753
• All API categories: https://manage.logicboxes.com/kb/node/119

---

Dependencies

• guzzlehttp/guzzle: HTTP client

License

This package, laravel-logicboxes-api is licensed under The MIT License (MIT). Please see License File for more information.

Is it any good?

Yes.

When people first hear about a new product, they frequently ask if it is any good. A Hacker News user remarked:

Note to self: Starting immediately, all raganwald projects will have a "Is it any good?" section in the readme, and the answer shall be "yes.".