Build8 Key-Value Service

The Build8 Key-Value service is a simple key-value database that allows you to store key-value pairs. This is a purely anonymous service so no registration is required. This also means that everyone can access a key's value if they know the path to the key. To avoid leaking your data, consider namespacing your key using a random value such as a UUID. See an example.

See the examples below on how to use the service.

Documentation

The Key-Value service can be accessed via HTTP or REST API. The Content-Type header determines what version is used.

The root path for the key-value store is https://kv.build8.io/key/. The name of your key is everything that follows that root path.

HTTP Response codes are used to determine the success or failure of a call to the service.

Write a key value


# curl -X POST https://kv.build8.io/key/path/to/your/key?v=value_of_your_key
value_of_your_key
(HTTP 202 returned)

# curl -X POST -H "Content-Type: application/json" --data '{"value": "value_of_your_key"}' https://kv.build8.io/key/path/to/your/key
{"key": "path/to/your/key", "value": "value_of_your_key"}
(HTTP 202 returned)

    

Read a key value


# curl https://kv.build8.io/key/path/to/your/key
value_of_your_key
(HTTP 200 returned)

# curl -H "Content-Type: application/json" https://kv.build8.io/key/path/to/your/key
{"key": "path/to/your/key", "value": "value_of_your_key"}
(HTTP 200 returned)

# curl https://kv.build8.io/key/key-not-there
(Empty response - HTTP 204 returned)


    

Delete a key and it's value


# curl -X DELETE https://kv.build8.io/key/path/to/your/key
(Empty response - HTTP 204 returned)

# curl -X DELETE -H "Content-Type: application/json" https://kv.build8.io/key/path/to/your/key
(Empty response - HTTP 204 returned)

    

Random key namespacing
Consider adding a random namespace to your key to prevent other users from reading your keys by iteration or walking the store.


# curl -X POST https://kv.build8.io/key/815db0f8-304c-41a7-8a8a-fc717fc215d9/my-key?v=secret
secret
(HTTP 202 returned)