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: apbr-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/apibrew/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>"
- 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