Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/larecipe/larecipe-swagger

Live API Testing Inside Your Documentation
https://github.com/larecipe/larecipe-swagger

Last synced: 8 days ago
JSON representation

Live API Testing Inside Your Documentation

Awesome Lists containing this project

README

        




LaRecipe Swagger


Let your users tests your APIs directly from the documentation!

# LaRecipe 🍪

**LaRecipe** is simply a code-driven package provides an easy way to create beautiful documentation for your product or application inside your Laravel app.

![LaRecipe Screenshot](https://larecipe.saleem.dev/images/packages/swagger.png#)

## Getting Started

1. Install the package via composer.

```bash
composer require binarytorch/larecipe-swagger
```

2. Use the provided VueJs component:

```html

```

3. Test your API:

![LaRecipe Screenshot](https://larecipe.saleem.dev/images/packages/swagger-screenshot.png)

3. Customize your component via props:

| Prop | Type | Default | Example |
| - | - | - | - |
| `base-url` | String | The current location origin | https://example.com |
| `endpoint` | String | - | /api/v1/users |
| `default-headers` | Object | - | { 'Content-Type': 'application/json' } |
| `default-params` | Object | - | { 'name': 'saleem' } |
| `default-method` | String | get | get,post,put,patch,update,delete |
| `has-common-headers` | Boolean | false | { 'Content-Type': 'application/json', 'Accept': 'application/json' } |
| `has-auth-header` | Boolean | false | { 'Authorization': 'Bearer token_here' } |

#### See [full larecipe documentation](https://larecipe.saleem.dev/docs)

## License

This library is licensed under the MIT License - see the [LICENSE.md](LICENSE) file for details.