harlekoy / apidocs
Replacement for Swagger. It is built for Laravel
Installs: 3 903
Dependents: 0
Suggesters: 0
Security: 0
Stars: 26
Watchers: 2
Forks: 2
Open Issues: 26
Requires
- illuminate/support: ~6
- laravel/framework: 5.7.*|5.8.*|6.0.*
- webpatser/laravel-uuid: ^3.0
Requires (Dev)
- mockery/mockery: ^1.1
- orchestra/testbench: ~3.0
- phpunit/phpunit: ~7.0
- sempro/phpunit-pretty-print: ^1.0
- dev-master
- v0.8.0
- v0.7.6
- v0.7.5
- v0.7.4
- v0.7.3
- v0.7.2
- v0.7.1
- v0.7
- v0.6
- v0.5
- v0.4.2
- v0.4.1
- v0.4
- v0.3.2
- v0.3.1
- v0.3
- v0.2
- v0.1
- dev-dependabot/npm_and_yarn/frontend/express-4.18.2
- dev-dependabot/npm_and_yarn/frontend/decode-uri-component-0.2.2
- dev-dependabot/npm_and_yarn/frontend/css-what-2.1.3
- dev-dependabot/npm_and_yarn/frontend/shell-quote-1.7.3
- dev-dependabot/npm_and_yarn/frontend/eventsource-1.1.1
- dev-dependabot/npm_and_yarn/frontend/url-parse-1.5.10
- dev-dependabot/npm_and_yarn/frontend/follow-redirects-1.14.8
- dev-dependabot/npm_and_yarn/frontend/node-sass-7.0.0
- dev-dependabot/npm_and_yarn/frontend/path-parse-1.0.7
- dev-dependabot/npm_and_yarn/frontend/ws-6.2.2
- dev-dependabot/npm_and_yarn/frontend/dns-packet-1.3.4
- dev-dependabot/npm_and_yarn/frontend/hosted-git-info-2.8.9
- dev-dependabot/npm_and_yarn/frontend/lodash-4.17.21
- dev-dependabot/npm_and_yarn/frontend/y18n-3.2.2
- dev-dependabot/npm_and_yarn/frontend/elliptic-6.5.4
- dev-dependabot/npm_and_yarn/frontend/axios-0.21.1
- dev-dependabot/npm_and_yarn/frontend/http-proxy-1.18.1
- dev-dependabot/npm_and_yarn/frontend/websocket-extensions-0.1.4
- dev-dependabot/npm_and_yarn/frontend/acorn-5.7.4
- dev-dependabot/npm_and_yarn/frontend/lodash.template-4.5.0
- dev-dependabot/npm_and_yarn/frontend/fstream-1.0.12
- dev-dependabot/npm_and_yarn/frontend/js-yaml-3.13.1
- dev-dependabot/npm_and_yarn/frontend/lodash.defaultsdeep-4.6.1
- dev-dependabot/npm_and_yarn/frontend/mixin-deep-1.3.2
- dev-dependabot/npm_and_yarn/frontend/tar-2.2.2
- dev-dependabot/npm_and_yarn/frontend/lodash.mergewith-4.6.2
This package is auto-updated.
Last update: 2024-10-09 12:17:32 UTC
README
This is where your description should go. Take a look at contributing.md to see a to do list.
Requirements
- Laravel 5.5 and above
Installation
Via Composer
$ composer require harlekoy/apidocs
After installing API Docs, publish its assets, and migration file using the apidocs:install
Artisan command.
$ php artisan apidocs:install
Updating API Docs
When updating, you should re-publish API Docs's assets:
$ php artisan apidocs:publish
Reread API routes
When updating your API docs route list, you should run this command to get your latest Laravel route:list
:
$ php artisan apidocs:routes
Usage
Access your API documentation in you browser
/apidocs/list
If you don't have any local server running in your machine, run this command first in you command line tool
php artisan serve
then it generate thishttp://127.0.0.1:8000
. Now you can access the path with that hostnamehttp://127.0.0.1:8000/apidocs/list
enjoy using it 😄.
Change log
Please see the changelog for more information on what has changed recently.
Testing
$ composer test
Contributing
Please see contributing.md for details and a todolist.
Security
If you discover any security related issues, please email me@harlekoy.com instead of using the issue tracker.
Credits
Road map
Laravel API Docs is still under development, I decided to ship it in this early stage so you can help me make it better. however, you can use it in production. Lets finish the task below so we can have a version 1 up and running with the right features needed.
Here's the plan for what's coming:
- Add support for API Docs custom path
- Add transition effect for groups and endpoints accordion
- Add a way to edit API Docs groups and endpoints in its the web interface
- Add tests.
- Add validation for required parameters
License
license. Please see the license file for more information.