An open API service indexing awesome lists of open source software.

https://github.com/radenkovic/jsonizr

REST API Documentation made simple. JSONizr creates documentation from json files! 😍
https://github.com/radenkovic/jsonizr

api documentation documentation-site documentation-tool json rest restful

Last synced: about 1 month ago
JSON representation

REST API Documentation made simple. JSONizr creates documentation from json files! 😍

Awesome Lists containing this project

README

          

# JSONizr
REST API Documentation made simple. JSONizr creates documentation from json files! 😍

![alt text](https://s14.postimg.org/5t44p1pg1/jsonizer.png "Jsonizer")

Create `json` files and copy-paste, describe endpoints, and JSONizr will create a nice website for you! Runs on Node/Express but you don't need any skill (except typing json).

## Install

1. git clone https://github.com/radenkovic/jsonizr
2. cd jsonizr
3. npm Install
4. npm start
5. open `localhost:3000/template/get`

Figure out everything else, or just ask :)

## Sample JSON

Here's sample endpoint description, will add better documentation later.

```
{
"title": "GET /api/template",
"description": "Write your description here.",
"method": "GET",
"input": {
"user_id": 1,
"full_name": "Dan"
},
"output": {
"full_name": "Dan",
"date_of_birth": "04-20-1989",
"github": "https://github.com/radenkovic",
"true": 1
},
"params": [
{
"name": "user_id",
"required": true,
"description": "User is important."
},
{
"name": "full_name",
"required": false,
"description": "Not required, but search is faster."

}
]
}
```

Result is as shown on intro image! Yay!

## Short Info

This is still a total sketch, will need a lot of work to get it in shape.