thomas-institut/standard-api

Standard API responses for use in Thomas-Institut projects

1.0.0 2026-05-22 12:30 UTC

Requires

• php: ^8.3

Requires (Dev)

• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^12.5

GPL-3.0-or-later

• Rafael Nájera

README

Standard API responses for use in Thomas-Institut projects.

This library provides a standard way to structure API responses in PHP projects, ensuring consistency across different services.

Installation

You can install the package via Composer:

composer require thomas-institut/standard-api

Usage

Success Response

The SuccessResponse class represents a successful API operation.

use ThomasInstitut\StandardApi\SuccessResponse;

$response = new SuccessResponse();
// $response->result will be ApiResult::Success
// $response->timeStamp will be set to current time

Error Response

The ErrorResponse class represents a failed API operation with a message and an HTTP status code.

use ThomasInstitut\StandardApi\ErrorResponse;

$response = new ErrorResponse('An error occurred', 404);
// $response->result will be ApiResult::Error
// $response->message will be 'An error occurred'
// $response->httpStatus will be 404

Development

Running Tests

To run the tests, use the following command:

composer test

Static Analysis

To run PHPStan for static analysis:

composer phpstan

Code Coverage

To generate a code coverage report (requires Xdebug):

composer test:coverage

License

This project is licensed under the GPL-3.0-or-later License - see the LICENSE file for details.