PHPackages                             nacosvel/openapi - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [HTTP & Networking](/categories/http)
4. /
5. nacosvel/openapi

ActiveLibrary[HTTP & Networking](/categories/http)

nacosvel/openapi
================

A lightweight OpenAPI HTTP kernel built on Guzzle, providing extensible request builders, endpoint chaining, and middleware pipelines.

v1.0.0(3mo ago)08MITPHPPHP ^8.0

Since Feb 12Pushed 3mo agoCompare

[ Source](https://github.com/nacosvel/openapi)[ Packagist](https://packagist.org/packages/nacosvel/openapi)[ Docs](https://github.com/nacosvel/openapi)[ RSS](/packages/nacosvel-openapi/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (4)Versions (2)Used By (0)

OpenAPI
=======

[](#openapi)

A lightweight OpenAPI HTTP kernel built on Guzzle, providing extensible request builders, endpoint chaining, and middleware pipelines.

[![GitHub Tag](https://camo.githubusercontent.com/599738c03376a7c5c3280b36367526d651a9e3f8fe6d78a59c04d8cf5c689eb5/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f7461672f6e61636f7376656c2f6f70656e617069)](https://github.com/nacosvel/openapi/tags)[![Total Downloads](https://camo.githubusercontent.com/52d6b6874b31f76f3163dda3f5493bcafc8a4b540d902b262228bda5481d0f1c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e61636f7376656c2f6f70656e6170693f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nacosvel/openapi)[![Packagist Version](https://camo.githubusercontent.com/11b27c3e070b7e48e1bd6073ee350c0fa322c224659674c36a7c8e514a4b6053/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e61636f7376656c2f6f70656e617069)](https://packagist.org/packages/nacosvel/openapi)[![Packagist PHP Version Support](https://camo.githubusercontent.com/af364d1fef64970f1709701305756b219d86cdc98b356445c34ce572fd9083c2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6e61636f7376656c2f6f70656e617069)](https://github.com/nacosvel/openapi)[![Packagist License](https://camo.githubusercontent.com/c94770f3bd343d6ea5f70233f0c3bc14cb44f4c0bf6cf4984f64d724e24cdd7f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6e61636f7376656c2f6f70656e617069)](https://github.com/nacosvel/openapi)

 Table of Contents1. [Installation](#installation)
2. [Usage](#usage)
3. [Contributing](#contributing)
4. [Contributors](#contributors)
5. [License](#license)

Installation
------------

[](#installation)

You can install the package via [Composer](https://getcomposer.org):

```
composer require nacosvel/openapi
```

\[[back to top](#readme-top)\]

Usage
-----

[](#usage)

### Builder Initialization

[](#builder-initialization)

```
use Nacosvel\OpenAPI\Builder;

$instance = Builder::factory([
    'mchid' => '190000****',
], [
    'base_uri' => 'https://httpspot.dev/',
]);
```

### Middleware Registration

[](#middleware-registration)

```
use Nacosvel\OpenAPI\Middleware\Middleware;

$instance->addMiddleware([
    new Middleware($builder->getClientDecorator()->getConfig()),
]);
```

### Synchronous Request

[](#synchronous-request)

```
$response = $builder->chain('anything/{code}')->get([
    'query' => [
        'id' => 1,
    ],
    'code'  => rand(100000, 999999),
]);

var_dump($response->getBody()->getContents());
```

### Asynchronous Requests

[](#asynchronous-requests)

```
use Psr\Http\Message\ResponseInterface;

$response = $builder->anything->_code_->getAsync([
    'query' => [
        'id' => 1,
    ],
    'code'  => rand(100000, 999999),
])->then(function (ResponseInterface $response) {
    return $response->getBody()->getContents();
})->wait();

var_dump($response);
```

Contributing
------------

[](#contributing)

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

\[[back to top](#readme-top)\]

Contributors
------------

[](#contributors)

Thanks goes to these wonderful people:

[ ![contrib.rocks image](https://camo.githubusercontent.com/ef27ff0328300e9c2ab70c2d24af04d4083babbc3ef71fea2aa7dd9c6e33853c/68747470733a2f2f636f6e747269622e726f636b732f696d6167653f7265706f3d6e61636f7376656c2f6f70656e617069)](https://github.com/nacosvel/openapi/graphs/contributors)Contributions of any kind are welcome!

\[[back to top](#readme-top)\]

License
-------

[](#license)

Distributed under the MIT License (MIT). Please see [License File](https://github.com/nacosvel/openapi/blob/main/LICENSE) for more information.

\[[back to top](#readme-top)\]

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance82

Actively maintained with recent releases

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity39

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

96d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/2da9b458375a1b7972b7c4d26a5bf8f3e48db305e8805da36f253956f33c5568?d=identicon)[jundayw](/maintainers/jundayw)

---

Top Contributors

[![jundayw](https://avatars.githubusercontent.com/u/16873970?v=4)](https://github.com/jundayw "jundayw (11 commits)")

---

Tags

middlewaresdkhttp clientGuzzleopenapibuilderpipelineNacosvel

### Embed Badge

![Health badge](/badges/nacosvel-openapi/health.svg)

```
[![Health](https://phpackages.com/badges/nacosvel-openapi/health.svg)](https://phpackages.com/packages/nacosvel-openapi)
```

###  Alternatives

[ory/hydra-client

Documentation for all of Ory Hydra's APIs.

17435.9k](/packages/ory-hydra-client)[ory/kratos-client-php

This is the API specification for Ory Identities with features such as registration, login, recovery, account verification, profile settings, password reset, identity management, session management, email and sms delivery, and more.

1529.2k3](/packages/ory-kratos-client-php)[ory/hydra-client-php

Documentation for all of Ory Hydra's APIs.

1710.8k](/packages/ory-hydra-client-php)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)