💮 EasyDB - Documentation

The super-simple database for utility tasks, one time stuff or anything you need to store for later usage.

EasyDB is a simple db when you need limited or one-time storage for your scripts or applications. Simply store and query data through our flexible REST api. The idea is more of a post-it system Start by making a call to our Register api with your email and you will be up and running in no time.

Note that this DB is rate limited both on number of save-calls (1 a minute), and size of save calls (256 kb), number of get calls are rate-limited to 10 a minute. Please look into our plans to increase that number.

Commands

User commands

A general note - all apis will return a status element and a message element, the status field is a bool field, and signifies if the action was successful or not. The message field is an informational element to support any debugging. All API-endpoints require the elements to be included in the body of the request. One exception is made for the Reset/Verify API endpoint to support email verification.

POST to easydb.org/register
Required elements:
email - type: string - needs to be a valid email address
Returns:
email
access_token
secret_id
status
message

Forgotten credentials

If you have forgotten or lost your access you can reset your account by sending your email address to this API. Note that there is a rate limiting active on this, so you can't call it too often.

POST to easydb.org/forgot
Required elements:
email - type: string - needs to be a valid email address
Returns:
email
status
message

Reset & verify account

This will reset your account and issue new credentials. This is the only API-end point that will accept a parameter or a body element.This can be called both through the API or by using the link sent to your email in the forgotten credentials API

POST to easydb.org/reset or GET to easydb.org/reset/{secret_id}

Required elements:
secret_id
Returns:
email
access_token
secret_id
status
message

Delete me

This will delete all your data, including your user. Use delete item below if you just want to delete some of your content.

POST to easydb.org/delete_me
Required elements:
email address
secret_id
Returns:
email
status
message

Data commands

Save

This will save some content with the id as an identifier, if you use an existing identifier it will update (overwrite) the exisiting content.

POST to easydb.org/save
Required elements:
access_token
id - this is the identifier you will later use to retrieve your data data - this is the data you want to be stored
Returns:
id
status
message

List

GET to easydb.org/list
Required elements:
access_token
Must be included in body of request
Returns:
ids - a list of id associated with the access_token
status
message

Get

GET to easydb.org/get
Required elements:
access_token
id
Must be included in body of request
Returns:
id
data
status
message

Delete

POST to easydb.org/delete
Required elements:
access_token
id
Must be included in body of request
Returns:
status
message