Important information before using KVStore.io

• In order to complete the registration to KVStore.io (and in addition to your RapidAPI account), YOU MUST INVOKE THE KVSTORE USERS/SIGNUP ENDPOINT. If you don't complete this step, your API calls will fail returning a 401 HTTP code (Unauthorized)

• Please, be careful and subscribe to KVStore.io using a different password than the one you're using to access the RapidAPI marketplace

Introduction

KVStore.io is a simple Key/Value API based storage service.

Client-side-only environments

If you need to store data, such as user forms, but you just have a static HTML website (such as GitHub pages), then this is what you need!

In order to use this feature, follow these simple steps:

• go to the KVStore website
• login using your credentials (the email & password you submitted by invoking the users/signup endpoint)
• type the command js
• copy and paste the HTML snippet into your target static page (it will inject the JS needed to save data to KVStore.io)
• invoke the storage/update endpoint to set the regex used to verify your referer domain (for security reasons, the KVStore.io javascript code will be injected into pages that are served from domains matching this regex)
• invoke the PUT on the Collection endpoint to set the 'public_write' flag to true. This enables the client-side-only feature (if false any attempt to write data will fail)
• once completed the setup, invoke this javascript function to store your data: kvstoreio(collection, key, value, callback), where:
  • collection (string): the name of the collection on KVStore.io (it must exist)
  • key (string)
  • value (string)
  • callback (function, optional): async method invoked after the save has been completed

RESTful API

Refer to the official KVStore.io API documentation on RapidAPI

Use-cases

KVStore.io supports two different usages:

• RESTful API intended for server-to-server environments (e.g. to manage server configurations, to store dynamic data coming from user forms and so on…)
• client-side-only applications (like static pages, e.g. gh-pages) for data provided by users, typically to store data from web forms

Please note: KVStore.io support both use-cases at the same time. The client-side-only feature may be enabled by setting the public_write collection flag (see PUT on the Collection endpoint)