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(4mo ago)08MITPHPPHP ^8.0

Since Feb 12Pushed 4mo 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 today

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

32

—

LowBetter than 69% of packages

Maintenance74

Regular maintenance activity

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

141d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/16873970?v=4)[Xander Moore](/maintainers/jundayw)[@jundayw](https://github.com/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

[illuminate/http

The Illuminate Http package.

11937.9M6.9k](/packages/illuminate-http)[guzzlehttp/guzzle-services

Provides an implementation of the Guzzle Command library that uses Guzzle service descriptions to describe web services, serialize requests, and parse responses into easy to use model structures.

25711.0M191](/packages/guzzlehttp-guzzle-services)

PHPackages © 2026

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