[!IMPORTANT] Upgrading from v2.x? Please read the Migration Guide for breaking changes and upgrade steps.

Installation Guide

To begin using the package, follow these steps to install it using Composer:

Install The Package 

composer require essa/api-tool-kit

This command will install the package in your Laravel project.

Publish Configuration Files

To customize the behavior of the package, you can publish the configuration files. Run the following command:

php artisan vendor:publish --provider="Essa\APIToolKit\APIToolKitServiceProvider" --tag="config"

This command will copy the configuration files into your project’s config directory, allowing you to modify settings as needed.

Standardize Error Responses

Use APIToolKit::registerExceptionRenderers() in your bootstrap/app.php:

use Essa\APIToolKit\APIToolKit;

return Application::configure(basePath: dirname(__DIR__))
    ->withExceptions(function (Exceptions $exceptions) {
        APIToolKit::registerExceptionRenderers($exceptions);
    })
    // ... other configuration
    ->create();

This registers all exception renderers using Laravel 11+’s closure-based approach, converting exceptions into standardized JSON error responses.

Utilize the API Response Trait in your controllers 

namespace App\Http\Controllers;

use Essa\APIToolKit\Api\ApiResponse;

class Controller extends BaseController
{
    use ApiResponse;
}

For more details, refer to API response

Table of contents