Gater Docs
Search…
Gater Database
Use the Table of Contents on the right-hand side of this page to navigate the Gater Database docs more easily.
Gater also gives developers access to a database to store whatever they need! To access the Gater database, you'll need a Gater UUID. To get your Gater UUID, fill out the form below. If for some reason it doesn't work, please email [email protected] to get your Gater UUID.
Please note that if your Gater UUID used in the following steps is invalid, Gater will return an error in JSON format. If no UUID is used, Gater will return either a 500 or 404 error. It is necessary to request a Gater UUID if you wish to use the Gater database features.
Your Gater UUID is subject to change while the Gater database is still in development. If a change in UUID is needed, you will be notified via email or text.
Please know that as of 5/13/21, the database is fully contained inside of a Replit program, and should not be considered secure. Please do not use the Gater database for commercial use or for storing personally identifying or confidential information (with the exception of your Gater UUID).
When the Gater database can be considered secure, and this warning no longer applies, this page will be updated. If you requested a Gater UUID, you will be personally notified of the update via email or text.

Adding to the Database

Everything you add to the Gater database is linked to you through your Gater UUID. Internally, Gater prefixes all of your database keys with your UUID so that your entries stay away from other Gater developers. But like the above warning (and like passwords in general), anyone with access to your Gater UUID can access your database entries.
To add an item to the Gater database, send a request to the following Gater API URL:
https://api.gater.dev/<uuid>/add/<key>/<value>
When sending a request to add to the Gater database, please replace <uuid> with your Gater UUID, <key> with an item title (or item identifier so-to-speak), and <value> with an item value. Each <key> has to be unique, meaning you can't have two keys named user. This is because the key is a unique pointer to your item in the database.
This also means that the <value> does not have to be unique because the key is the only pointer the database needs to find your item.
After sending the database add request, Gater will return the key and value created (like a confirmation):
1
{"main":
2
3
{
4
"key":"test",
5
"value":"value"
6
}
7
8
}
Copied!

Retrieving from the Database

Similar to the add function, retrieving requires your unique Gater UUID for the function to work. The URL to retrieve an item from the Gater database looks something like this:
https://api.gater.dev/<uuid>/get/<key>
Similar to a lock, the key is all you need to get your information. So like the add function, replace <uuid> with your Gater UUID, and <key> with your item key.
Gater will return a JSON output similar to the confirmation returned when adding a new entry.
1
{"main":
2
3
{
4
"key":"test",
5
"value":"value"
6
}
7
8
}
Copied!

Deleting Entries

Deleting entries is very simple with Gater. The URL format for deleting entries is shown below:
https://api.gater.dev/<uuid>/delete/<key>
Like the add and get functions, replace <uuid> with your Gater UUID, and <key> with the item key you wish to delete.
Because this is an API, there is no confirmation message or warning. The key and value pair will be deleted immediately.
When requesting the deletion of an entry, Gater will return the following (assuming all given information is correct):
1
{"main":
2
3
{
4
"status":"Delete Successful"
5
}
6
7
}
Copied!
Last modified 4mo ago