https://github.com/aershov24/appy
Appy web service
https://github.com/aershov24/appy
Last synced: 4 days ago
JSON representation
Appy web service
- Host: GitHub
- URL: https://github.com/aershov24/appy
- Owner: aershov24
- Created: 2016-02-16T12:40:50.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2016-03-11T01:58:15.000Z (over 9 years ago)
- Last Synced: 2025-09-02T17:52:46.551Z (about 1 month ago)
- Language: JavaScript
- Size: 1.28 MB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Appy Web Service
## Description
Appy Web Service uses the following modules and tools:
Dependencies:
* Express as HTTP server
* Winston as Logging
* jsonwebtoken as JSON Web Token implementation
Dev dependencies are:
* APIDoc as Inline documentation tool
* nodemon as script changing monitor
## Installation
Run the following commands:
```
git clone https://github.com/aershov24/appy.git
cd appy
npm install
npm run nodemon
```
## Rest API inline documentation
The template uses APIdoc tool to create inline documentation for RESTful web APIs.
Use the following commented code as an example for your API methods documentation:
```
/**
* @api {post} /api/authentification User authentification
* @apiName Authentification
* @apiGroup Authentification
*
* @apiParam {Object} details Login details
* @apiParamExample {json} Request-Example:
* {
* "name" : "aershov24@gmail.com",
* "password" : "demo"
* }
* @apiSuccess {Object} object User token object or error message
* @apiSuccessExample {json} Sucess-Response:
* {
* "success": true,
* "message": "User authentificated",
* "token": "eyJ0eXAiOiJKV1QiLCJhbGc"
* }
* @apiError {Object} 403 Failed authentification info
* @apiErrorExample {json} Error-Response:
* {
* "success": false,
* "message": "Authentication failed. Wrong password."
* }
*/
```
See more about ApiDoc [here](http://apidocjs.com/)
## Create ApiDoc Documentation
Run the following commands:
```
npm run apidoc
```