apibrew

README

- https://apibrew.io

Demo http://tisserv.net:9009/ (swagger docs: http://tisserv.net:9009/docs)

For using demo, you need to use following config on ~/.dhctl/config

type: server
servers:
  - name: local
    host: tisserv.net:9009
    authentication:
      username: admin
      password: admin
defaultServer: local

Introduction

Everything is a Resource. And Everything has a CRUD API

With API Brew, you can create CRUD APIs for your data in a few minutes

country.yml

type: resource
name: country
properties:
  - name: name # name of the property
    type: STRING # type of the property
    length: 255
    required: true
    unique: true
  - name: description # name of the property
    type: STRING # type of the property
    length: 255

apbr apply -f country.yml

So you are ready, you have fully established Rest API for country resource

axios.post('http://localhost:9009/country', {
  name: 'Country1',
  description: 'Sample Country 1'
})

You can build entire application with resources and references between them (like relations in relational databases)

Everything can be written by resources, not? Let's extend our country resource

countryExtension.onCreate(async (country) => {
        country.description = country.description + ' - Extended'

        return country
    })

So we have extended our country resource with modification description on create

So, with API Brew, you can create your application with resources and you can customize behavior of your resources with extensions

About

API Brew is a Low Code software that allows to create various Grpc and Rest APIs from various database platforms

Features

• Declarative - API Brew is declarative. You can define your schema in a declarative way, it will create your APIs
• Low Code - With API Brew, you can create APIs for your data without coding. But you can also extend your APIs with extensions, so you can customize behavior of your Resources/Apis
• Rest API - As you create resources, Rest Apis for them is made automatically
• Grpc - As you create resources, Grpc Apis for them is made automatically
• Database agnostic - API Brew is using Postgresql database by default, but it also supports various databases. Including Mongo, Mysql, Redis, etc.
• CRUD - Crud is on the heart of API Brew.
• Swagger - Swagger docs are generated automatically
• Authentication - API Brew supports various authentication methods. Including JWT authentication etc.
• Authorization - API Brew supports authorization. You can define permissions for your resources
• Multi Database - You can define multiple databases and do operations on top of them
• Scalable - API Brew is scalable. You can run it on multiple instances, and it will work as expected, as API Brew does not have any data internally, you can scale it.
• Extensible - API Brew is extensible. You can extend your resources with extensions. You can also extend your APIs with extensions
• CLI support - API Brew has a cli tool to manage your resources, dataSources, etc. It is called apbr
• Docker - API Brew is dockerized. You can run it on docker
• Docker Compose - API Brew is docker-compose ready. You can run it on docker-compose, see docker-compose
• Kubernetes - API Brew is kubernetes ready. You can run it on kubernetes, see kubernetes

Use Cases

• Creating backend for your mobile application or website
• Creating backend for your existing database
• Managing your data in a CRUD fashion
• Creating Standardized, well documented APIs for your data

Quick Example

Easy Installation

curl -L https://raw.githubusercontent.com/tislib/apibrew/master/deploy/easy-install/run.sh | bash

For more detailed installation, see Installation

Let's create a resource

country.yml

type: resource
name: country
properties:
  - name: name
    type: STRING
    length: 255
    required: true
    unique: true
  - name: description
    type: STRING
    length: 255

apbr apply -f country.yml

Swagger: http://localhost:9009/docs/index.html

# Create Country
curl -X POST --location "http://localhost:9009/country" \
    -H "Authorization: <token>" \
    -d "{
   \"name\": \"Country1\",
   \"description\": \"Sample Country 1\"
}"

# List Countries
curl "http://localhost:9009/country" -H "Authorization: <token>"

Docs

• Tutorials - Tutorials
• Installation - Installation
• General - General information about API Brew
• API - GRPC and Rest API documentation
• CLI - CLI interface(apbr) documentation
• Proto - Proto documentation
• SDK - SDK documentation