Skip to content

Areoxy/easy_api_builder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

52 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Easy_API_Builder

A python package to easily create simple rest-apis in python.

pip install easy-api-builder

Requiremnets: <= python 3.6

Required modules –> Flask, requests

Documentation

Build an API with easy_api_builder:

from easy_api_builder.builder import apiBuilder
json_response = \
{
    "easy_api_builder.Version": 0.1,
    "downloads": "200+"
}

builder = apiBuilder()
builder.create_get_api(json_response, "/")
builder.start(port=80)

Build an api with authorization by an api key

from easy_api_builder.builder import apiBuilder
json_response = \
{
    "easy_api_builder.Version": 0.1,
    "downloads": "200+"
}

builder = apiBuilder()
builder.build_auth_api(json_response, ["key1", "key2], "/api/")
builder.start(port=80)

To get a response from the api you must make a requests to this url: http://yourdomain.com/api?key=key1/

Build a Documentation Page for your API:

# Import the required Packages
from easy_api_builder.builder import apiBuilder

json_response = \
{
    "easy_api_builder.Version": 0.1,
    "downloads": "200+"
}

# Define the apiBuilder

builder = apiBuilder()

# Create a GET API
builder.build_get_api(json=json_response, path="/")

# Create a Documentation Page for the API
builder.create_docs(sitename="Cocumentation", sitedescription="Official Documentation for easy_api API", path="/docs", docs="How to use our API? etc...")

# Start the API on defualt Port 80
builder.start(port=80)

Build a custom docs page

Note: You can create only a Documentation Page too:

# Import the Required Packages
from easy_api_builder.builder import apiBuilder
# Define the apiBuilder

builder = apiBuilder()

# Create a Documentation Page
builder.create_docs(sitename="Cocumentation", sitedescription="Official Documentation for easy_api API", path="/docs", docs="How to use our API? etc...")

# Start the API on defualt Port 80
builder.start(port=80)

You can change the path. For example “/api/v3”

How to customize the Documentation- and Error Page?

To customize the Documentation- and error page, go in the package folder and edit the index.html and the 404.html