An API built to show off hapi.js
This web API was built to demonstrate some of the hapi features and functionality. It was part of a talk given at Asyncjs on the 10 October 2013. The API is a simple calculator that allows you to add, subtract, divide or multiple two numbers. To demonstrate a more common set of API calls I also added methods to store sums into a mongodb database.
The project makes use of a hapi.js plugin hapi-swagger which self documents the API using the Swagger UI interface. It provides simple forms which developers can use to quickly interact with your API and learn how it works. The forms and documentation are built from the standard hapi.js routes object.
$ git clone https://github.com/glennjones/be-more-hapi.git
$ curl -L https://github.com/glennjones/be-more-hapi/tarball/master | tar zx
- Move into the project directory
$ cd be-more-hapi
$ npm install
- Start the mongodb server
$ node bin/be-more-hapi
- Connect to the server using
Example of using tags to show a subset of an API
All the sum endpoints are http PUT requests. Where the two numbers are the last two fragments of the URL:
If the sum is completed without error the response is also a simple format:
The error format always has 3 properties; code, error and message. There is an optional fourth property validation which is added if the input is in the incorrect format.
"code": 400"error": "Bad Request""message": "the value of b must be a number""validation":"source": "path""keys":"b"
Mocha integration test
The project has example integration and unit tests. To run the test within the project type the following command
$ mocha --reporter list