zeroapibackend
v1.0.3
Published
The world's first API-ready database with a REST interface
Downloads
3
Readme
ZeroAPIBackend
The world's first API-ready database with a REST interface
ZeroAPIBackend is a CLI tool that allows you to instantly create a Database - REST API by simply running the "zeroAPI run" command.
This database tool requires no database setup because it is also a database, and you don't need to define tables or perform complex configurations. Everything is generated on the fly when you consume an endpoint, offering a hassle-free solution for rapid API development for developers and data experts.
Features
- Automatic API Creation: Launch a fully functional REST API with a single command.
- No Database Setup Required: Avoid the complexities of setting up and managing a database.
- Dynamic Table Handling: Create, read, update, and delete records in any table without predefined schemas.
- Designed for Data Analysts: Obtain the data dictionary easily via an endpoint, and by running the CLI with the -d parameter, you can automatically generate a completely clean new database.
- Data Cleaning and Statistics Endpoints: Automatically obtain statistics like mean, median, mode, standard deviation, quartiles, etc.
- Frontend-Based Queries: Perform all queries directly from the frontend, without needing to write backend code or install any database engine.
- Advanced Security: Protect your queries with an ACL configuration JSON and JWT Bearer token-based authentication.
- Automatic public share endpoints across (ngrok plugin)
- Dunp
Get started
Prerequisites
- Install node js 20+ and npm
Install
npm install -g zeroapibackend
How to use
Run
To execute in default port 3000 and default database only run and then visit http://localhost:3000
zeroAPI run
Or if you prefer define a custom port for example 5050 to execute and then visit http://localhost:5050
zeroAPI run -p 5050
Or if you want to use a new custom clear datatable use -d + datatable name
zeroAPI run -p 5050 -d erick
Or if you want to publish on internet your API using ngrok
zeroAPI run -p 5050 -d erick -ngr <true or ngrok token string>
Commands
zeroAPI dump Command
Description Dumps a specified database by name.
Options
- -d, --dir <dir...>: Full path directory where the dump will be saved.
- -n, --name <name...>: Database name.
Usage Example
zeroAPI dump --name myDatabase --dir /path/to/save/dump
zeroAPI restore Command
Description Restores a database from a specified ZIP file.
**Note :This function will replace all registers in the target database.
Options
- -d, --dir <dir...>: Full path directory of the source ZIP file.
- -n, --name <name...>: Database name. Usage Example
zeroAPI restore --name myDatabase --dir /path/to/zip/file.zip
zeroAPI drop Command
Description Drops a specified database by name.
Options
- -n, --name <name...>: Database name.
Usage Example
zeroAPI drop --name myDatabase
Endpoints
Create Multiple Records:
- POST /api/:table/many
- Description: Create multiple records in the specified table.
- POST /api/:table/many
Create a Single Record:
- POST /api/:table/
- Description: Create a single record in the specified table.
- POST /api/:table/
Get Multiple Records:
- GET /api/:table/
- Description: Retrieve multiple records from the specified table.
- GET /api/:table/
Get a Single Record Based on Conditions:
- GET /api/:table/one
- Description: Retrieve a single record from the specified table that meets the specified conditions.
- GET /api/:table/one
Get a Single Record by ID:
- GET /api/:table/:id
- Description: Retrieve a single record by its ID from the specified table.
- GET /api/:table/:id
Update or Create a Record:
- PUT /api/:table/findOrCreate
- Description: Update an existing record or create a new one in the specified table.
- PUT /api/:table/findOrCreate
Update a Record by ID:
- PUT /api/:table/:id
- Description: Update a record by its ID in the specified table.
- PUT /api/:table/:id
Update Records Based on Conditions:
- PUT /api/:table/
- Description: Update records in the specified table that meet the specified conditions.
- PUT /api/:table/
Delete a Record by ID:
- DELETE /api/:table/:id
- Description: Delete a record by its ID from the specified table.
- DELETE /api/:table/:id
Get statistics like mean, mode, avg, etc of a field:
- GET /api/:table/statistics?select=< fields comma separed >
- Description: gets statisctics from a column in query
- GET /api/:table/statistics?select=< fields comma separed >
Query parameters
To use query parameters in the API routes, you can specify various parameters in the URL that will modify the behavior of the CRUD operations. Below are some examples of how to use these parameters:
select: Field Selection The select parameter is used to specify the fields you want to include in the response.
Example: Retrieve only the name and email fields from the records in the users table:
curl -X GET "http://localhost:3000/api/users/?select=name,email"
where: Specific Conditions The where parameter is used to filter records based on certain conditions.
Example: Retrieve all records from the users table where age is equal to 30:
curl -X GET "http://localhost:3000/api/users/?where[age]=30"
paginate: Pagination The paginate parameter is used to paginate the results, specifying the number of records per page and the page number.
Example: Retrieve the second page of records from the users table, with 10 records per page:
curl -X GET "http://localhost:3000/api/users/?paginate[limit]=10&paginate[page]=1"
sort: Sorting The sort parameter is used to sort the results based on one or more fields.
Example: Retrieve all records from the users table sorted by createdAt in descending order:
curl -X GET "http://localhost:3000/api/users/?sort[createdAt]=-1"
populate: Relationships The populate parameter is used to include related documents from other collections.
Example: Retrieve all records from the orders table and include the details of the related users:
curl -X GET "http://localhost:3000/api/orders/?populate[localFields]=userId&populate[tables]=users&populate[foreignFields]=_id"
Combined Examples
You can combine several query parameters to perform more complex queries.
Example: Retrieve the first page of records from the users table, with 5 records per page, only the name and email fields, sorted by createdAt in ascending order, and where age is equal to 25:
curl -X GET "http://localhost:3000/api/users/?select=name,email&paginate[limit]=5&paginate[page]=0&sort[createdAt]=1&where[age]=25"
Usage in Create Operations
You can use select, populate, and other parameters in create operations to specify which fields to include in the response and how to relate the new documents.
Example: Create a new record in the users table and return only the name and email fields:
curl -X POST "http://localhost:3000/api/users/?select=name,email" -H "Content-Type: application/json" -d '{
"name": "Jane Doe",
"email": "[email protected]",
"age": 28
}'
Detailed Explanation of How Populates Work in the Library
The populateConstructor function is used to fetch related data from other tables and incorporate it into the main query result. This mimics the behavior of SQL joins in a NoSQL database by manually linking documents based on specified fields.
How populateConstructor Works
- Parameter Parsing:
The populate object contains localFields, tables, and foreignFields, which are comma-separated strings specifying the fields and tables involved in the population. These strings are split into arrays for further processing.
- Iteration Over Records:
For each item in the list_of_elements (the main query result), the function iterates over the specified fields and tables. For each field-table combination, a filter is constructed to match the related documents in the foreign table.
- Filter Construction:
If the value of the localField in the current item is a string, a simple equality filter is created. If the value is an array, an $in filter is created to match any of the values in the array.
- Field Selection:
If populateFields are specified, only the indicated fields are selected from the foreign table.
- Database Query:
The function initializes the connection to the foreign table and executes the query with the constructed filter and field selection. The results are stored back into the original item, replacing the localField value with the related documents.
- Final Assembly:
The populated items are collected into a new array and returned. Example of Using Populates in CLI To use the populate parameter in your CLI to fetch related data from other tables, follow this example:
Scenario
You have two collections: orders and users. Each order document has a userId field referencing a user. You want to retrieve orders and include user details in the result.
curl -X GET "http://localhost:3000/api/orders/?populate[localFields]=userId&populate[tables]=users&populate[foreignFields]=_id"
How the Example Works
- Query URL:
- The URL specifies the orders table and includes the populate parameter with localFields, tables, and foreignFields.
- localFields=userId: Indicates the field in the orders collection that references the users collection.
- tables=users: Specifies the foreign table (users) to fetch data from.
- foreignFields=_id: Specifies the field in the users collection that matches the userId field in the orders collection.
- Result:
- The server will process the request, fetch orders, and for each order, it will look up the corresponding user in the users collection.
- The userId in each order will be replaced with the full user document.
Extended Example with Field Selection
You can also specify which fields to include from the related documents using populateFields.
Example Command
curl -X GET "http://localhost:3000/api/orders/?populate[localFields]=userId&populate[tables]=users&populate[foreignFields]=_id&populateFields[users]=name,email"
How the Extended Example Works
- Query URL:
- The URL includes an additional populateFields parameter specifying which fields to include from the users collection. populateFields[users]=name,email: Indicates that only the name and email fields from the users collection should be included in the response.
- Result:
- The server will fetch orders and populate the userId field with user documents that include only the name and email fields.
Full example for python
import requests
import json
BASE_URL = "http://localhost:3000/api"
# Helper function to print response
def print_response(response):
print("Status Code:", response.status_code)
try:
print("Response JSON:", response.json())
except json.JSONDecodeError:
print("Response Text:", response.text)
# 1. Create Multiple Records
def create_many_users():
url = f"{BASE_URL}/users/many"
payload = [
{"name": "Alice", "email": "[email protected]", "age": 30},
{"name": "Bob", "email": "[email protected]", "age": 25}
]
headers = {"Content-Type": "application/json"}
response = requests.post(url, headers=headers, data=json.dumps(payload))
print_response(response)
# 2. Create a Single Record
def create_user():
url = f"{BASE_URL}/users/"
payload = {"name": "Charlie", "email": "[email protected]", "age": 28}
headers = {"Content-Type": "application/json"}
response = requests.post(url, headers=headers, data=json.dumps(payload))
print_response(response)
# 3. Get Multiple Records
def get_users():
url = f"{BASE_URL}/users/"
response = requests.get(url)
print_response(response)
# 4. Get a Single Record by ID
def get_user_by_id(user_id):
url = f"{BASE_URL}/users/{user_id}"
response = requests.get(url)
print_response(response)
# 5. Get a Single Record Based on Conditions
def get_user_by_condition():
url = f"{BASE_URL}/users/one?where[age]=28"
response = requests.get(url)
print_response(response)
# 6. Update or Create a Record
def update_or_create_user():
url = f"{BASE_URL}/users/findOrCreate"
payload = {"name": "David", "email": "[email protected]", "age": 32}
headers = {"Content-Type": "application/json"}
response = requests.put(url, headers=headers, data=json.dumps(payload))
print_response(response)
# 7. Update a Record by ID
def update_user_by_id(user_id):
url = f"{BASE_URL}/users/{user_id}"
payload = {"age": 29}
headers = {"Content-Type": "application/json"}
response = requests.put(url, headers=headers, data=json.dumps(payload))
print_response(response)
# 8. Delete a Record by ID
def delete_user_by_id(user_id):
url = f"{BASE_URL}/users/{user_id}"
response = requests.delete(url)
print_response(response)
# Example usage
if __name__ == "__main__":
create_many_users()
create_user()
get_users()
# Replace 'user_id' with an actual ID from your database
user_id = "60d0fe4f5311236168a109ca" # Example ID
get_user_by_id(user_id)
get_user_by_condition()
update_or_create_user()
update_user_by_id(user_id)
delete_user_by_id(user_id)
Full example for javascript
const axios = require('axios');
const BASE_URL = "http://localhost:3000/api";
// Helper function to print response
function printResponse(response) {
console.log("Status Code:", response.status);
console.log("Response Data:", response.data);
}
// Helper function to print errors
function printError(error) {
if (error.response) {
console.log("Error Status Code:", error.response.status);
console.log("Error Response Data:", error.response.data);
} else {
console.log("Error:", error.message);
}
}
// 1. Create Multiple Records
async function createManyUsers() {
const url = `${BASE_URL}/users/many`;
const payload = [
{name: "Alice", email: "[email protected]", age: 30},
{name: "Bob", email: "[email protected]", age: 25}
];
try {
const response = await axios.post(url, payload, {headers: {'Content-Type': 'application/json'}});
printResponse(response);
} catch (error) {
printError(error);
}
}
// 2. Create a Single Record
async function createUser() {
const url = `${BASE_URL}/users/`;
const payload = {name: "Charlie", email: "[email protected]", age: 28};
try {
const response = await axios.post(url, payload, {headers: {'Content-Type': 'application/json'}});
printResponse(response);
} catch (error) {
printError(error);
}
}
// 3. Get Multiple Records
async function getUsers() {
const url = `${BASE_URL}/users/`;
try {
const response = await axios.get(url);
printResponse(response);
} catch (error) {
printError(error);
}
}
// 4. Get a Single Record by ID
async function getUserById(userId) {
const url = `${BASE_URL}/users/${userId}`;
try {
const response = await axios.get(url);
printResponse(response);
} catch (error) {
printError(error);
}
}
// 5. Get a Single Record Based on Conditions
async function getUserByCondition() {
const url = `${BASE_URL}/users/one?where[age]=28`;
try {
const response = await axios.get(url);
printResponse(response);
} catch (error) {
printError(error);
}
}
// 6. Update or Create a Record
async function updateOrCreateUser() {
const url = `${BASE_URL}/users/findOrCreate`;
const payload = {name: "David", email: "[email protected]", age: 32};
try {
const response = await axios.put(url, payload, {headers: {'Content-Type': 'application/json'}});
printResponse(response);
} catch (error) {
printError(error);
}
}
// 7. Update a Record by ID
async function updateUserById(userId) {
const url = `${BASE_URL}/users/${userId}`;
const payload = {age: 29};
try {
const response = await axios.put(url, payload, {headers: {'Content-Type': 'application/json'}});
printResponse(response);
} catch (error) {
printError(error);
}
}
// 8. Delete a Record by ID
async function deleteUserById(userId) {
const url = `${BASE_URL}/users/${userId}`;
try {
const response = await axios.delete(url);
printResponse(response);
} catch (error) {
printError(error);
}
}
// Example usage
(async () => {
await createManyUsers();
await createUser();
await getUsers();
// Replace 'userId' with an actual ID from your database
const userId = "60d0fe4f5311236168a109ca"; // Example ID
await getUserById(userId);
await getUserByCondition();
await updateOrCreateUser();
await updateUserById(userId);
await deleteUserById(userId);
})();
If you want to get information from database
Visit GET : http://localhost:3000/database/describe
Example of statistics endpoint
const options = {method: 'GET', headers: {'User-Agent': 'insomnia/2023.5.8'}};
fetch('http://localhost:5051/api/users/statistics?select=age%2Cmonthly_income%2Cdoctor_visits%2Ccountry', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
Response example
{
"status": 200,
"collection": "users",
"message": "Get Many Success",
"data": {
"age": {
"statistics": {
"count": 20,
"sum": 649,
"mean": 32.45,
"median": 32,
"mode": [
29
],
"min": 22,
"max": 45,
"range": 23,
"std": 6.445735024029455,
"variance": 41.5475,
"quartiles": {
"Q1": 27.75,
"Q2": 32,
"Q3": 37.25
},
"iqr": 9.5
}
},
"monthly_income": {
"statistics": {
"count": 20,
"sum": 99400,
"mean": 4970,
"median": 5050,
"mode": [
4500,
6800
],
"min": 2800,
"max": 7200,
"range": 4400,
"std": 1309.6182649917494,
"variance": 1715100,
"quartiles": {
"Q1": 3925,
"Q2": 5050,
"Q3": 5925
},
"iqr": 2000
}
},
"doctor_visits": {
"statistics": {
"count": 18,
"sum": 39,
"mean": 2.1666666666666665,
"median": 2,
"mode": [
1
],
"min": 1,
"max": 4,
"range": 3,
"std": 1.0137937550497031,
"variance": 1.0277777777777777,
"quartiles": {
"Q1": 1,
"Q2": 2,
"Q3": 3
},
"iqr": 2
}
},
"country": {
"statistics": {
"mode": [
"USA",
"Canada",
"UK",
"Australia",
"New Zealand",
"Ireland",
"Spain",
"Germany",
"France",
"South Korea",
"Italy",
"Netherlands",
"Japan",
"Brazil",
"South Africa",
"Russia",
"Mexico",
"Argentina",
"China",
"India"
],
"mostFrequent": [
"USA",
"Canada",
"UK",
"Australia",
"New Zealand"
],
"leastFrequent": [
"USA",
"Canada",
"UK",
"Australia",
"New Zealand"
],
"uniqueValues": [
"USA",
"Canada",
"UK",
"Australia",
"New Zealand",
"Ireland",
"Spain",
"Germany",
"France",
"South Korea",
"Italy",
"Netherlands",
"Japan",
"Brazil",
"South Africa",
"Russia",
"Mexico",
"Argentina",
"China",
"India"
]
}
}
}
}