Get a basic REST service (for testing purposes) up an running in minutes.
easy-rest-test enables you to provide a REST service within minutes based on a few given .csv files. Extend your REST service by just adding additional .csv files ...
There are only a few steps you need to follow:
- Clone the repository (
git clone email@example.com:stefanwalther/easy-rest-test.git)
- Do an
- Place the .csv file you want to expose through REST in the
- Start the service by running
npm run start
Your .csv files are now exposed as a REST endpoint, e.g.:
- The content of the file
- Is now available at
The following endpoints are available:
<server-url>/health-check- Health check for the entire service.
<server-url>/api-docs- Swagger / OpenAPI documentation (not implemented, yet).
Endpoints based on the files your are providing
For each of the datasets (right now only .csv files) you have provided, the following endpoints are exposed:
<server-url>/:dataset- e.g. http://localhost:3000/sales-data for the file
<server-url>/file/:dataset- to download the entire file.
The entire idea of this solution is to deploy a REST service with some basic data (e.g. for testing purposes) within less than a minute:
Using HerokuAssuming that you have cloned the repository, follow these steps to deploy your basic REST service:
- Make sure you have a Heroku account
- Create a new heroku app
- Give it a name, e.g
- Create the app (
- Under your newly created app,
Deployment methodand select
- Enter the name of your GitHub repository and then click
- That's it, deploy your service by
Enable Automatic Deploysor
- manually using
- Access one of your data-sources by hitting e.g
Right now only
.csv files are supported and placed into the
Conventions for .csv files
- The .csv file contains a header
- The .csv file uses semicolon (
;) as a delimiter
This is currently a very early iteration of the basic idea of "exposing .csv files through REST".
Any feedback is very appreciated!
So far the following additions are planned:
- (feat): Error handling in case of invalid .csv files
- (feat): Expose datasets via OpenApi/Swagger
- (feat): HATEOAS links
- (feat): In memory storage of datasets
- (feat): Support paging
- (feat): Support different authentication methods
- (ci): Docker Image
- (ci): CircleCI Tests
- (test): More integration tests
- (docs): Instructions how to deploy within minutes to heroku & Co.
- (test): Coverage report
Pull requests and stars are always welcome. For bugs and feature requests, please create an issue. The process for contributing is outlined below:
- Create a fork of the project
- Work on whatever bug or feature you wish
- Create a pull request (PR)
I cannot guarantee that I will merge all PRs but I will evaluate them all.
This file was generated by verb-generate-readme, v0.6.0, on January 11, 2019.