README

What is easyAPI?

easyAPI is skeleton REST API application and integrated with swagger to generate documentation API for Codeigniter 4. With easyAPI you can generate REST API less than 5 minutes.

Installation & setup

composer require asligresik/easyapi

Publish initial file for swagger documentation

php spark api:publish this command will copy file
- src/Controllers/Swagger.php to app/Controllers
- src/Views to app/Views
- src/public/assets to public/assets
- src/Commands/API/template to app/Commands/API/template

Override default template

edit file in folder app/Commands/API/template

Generate REST API

php spark api:generate or php spark api:generate -p Modules\API\ to generate file in spesific folder after that, system will ask you table name will generate that REST API. We can choose one table or all, if we want generate all write all or write one table name exist in your database If there is no error, system will generate for you controller, model and entity file.
Last you must add new route will display in last command to app/Config/Routes.php.
Generate api.yaml using command ./vendor/bin/openapi -o ./public/assets/api.yaml ./app to show API docs using swagger using datasource format yaml (default)
Generate api.json using command ./vendor/bin/openapi -o ./public/assets/api.json ./app to show API docs using swagger using datasource format json (optional)
Open API documentation in http://localhost:8080/swagger

Feature

Support searching data using multiple column
Support searching date column
Support pagination

Example

join with other table, you can look at ArtikelKategoriModel.php
example parameter in swagger for order data {"order":[{"id":"desc"},{"tgl_upload":"asc"}]}
example parameter in swagger for search data {"search":[{"id_kategori":1}]}
example parameter in swagger for search range data {"search":[{"tgl_upload":{"start":"2016-01-01", "end":"2020-01-01"} }]}
example parameter in swagger for search using like {"search":[{"judul":"membangun%25"}]} or {"search":[{"judul":"%25membangun%25"}]} use %25 not % you can place %25 on before, after and combination before and after as your keyword to search data
search data based on column name {base_url}/artikels?search[id_kategori]=1
order data based on column name {base_url}/artikels?order[id]=desc&order[tgl_upload]=asc
search and order data based on column name {base_url}/artikels?search[id_kategori]=1&order[id]=desc&order[tgl_upload]=asc
search with pagination {base_url}/artikels?page=1&limit=10
search and order with pagination {base_url}/artikels?search[id_kategori]=1&order[id]=desc&order[tgl_upload]=asc&page=1&limit=10
search using between operator if we want filter data based range of date or etc {base_url}/artikels?search[tgl_upload][start]=2016-01-01&search[tgl_upload][end]=2020-01-01
search using keyword {base_url}/artikels?search[judul]=membangun%25 or {base_url}/artikels?search[judul]=%25membangun%25 will produce like operator on query
Search with multiple column
http://localhost:8080/wpOptions?search[option_name]=%mailserver%&search[autoload]=yes&search[option_id][start]=17&search[option_id][end]=18&limit=20

Todo

create example using this application

Copyright

easyApi dikembangkan dan dimaintain oleh asligresik

Lisensi

Lisensi dari easyApi adalah MIT License namun proyek yang dibangun menyeseuaikan dengan kebijakan masing-masing

asligresik / easyapi

Maintainers

Details