Documentation/rest api web

doc/news/_preparation_next_release.md

@@ -321,6 +321,7 @@ The following section lists news about the [modules](https://www.libelektra.org/
 ### Reference
 
 - Fixed missing Metadata in README and METADATA.ini. _(Michael Zronek)_
+- Update README.md web tool to show, how to test REST API on localhost _(Dmytro Moiseiuk)_
 
 ### Specload
 

src/tools/web/README.md

@@ -114,6 +114,53 @@ Elektra web consists of multiple components:
 - [elektrad](https://master.libelektra.org/doc/api_blueprints/elektrad.apib), documentation: https://elektrad.docs.apiary.io/
 - [webd](https://master.libelektra.org/doc/api_blueprints/webd.apib), documentation: https://elektrawebd.docs.apiary.io/
 
+## Test REST API on localhost
+
+In order to test API on localhost, your have to start elektrad instance. You can do it in two ways:
+
+- run manually
+
+  - `cd libelektra/src/tools/web`
+  - `cd elektrad`
+  - `npm install`
+  - `npm start` (replaces `kdb run-elektrad`)
+
+- by installing elektrad tool together with Elektra and run it
+  - please see the documentation [here](https://www.libelektra.org/tools/web) on how to install and run the elektra-web tool
+
+Now the server is runing on [http://localhost:33333](http://localhost:33333). After that you can test API with help of Postman or other tool, which allows to send REST API requests.
+
+As an example:
+
+Let's create the new key-value pair `user/test`:
+
+```sh
+kdb set user/test 5
+```
+
+Now, the command 
+
+```sh
+curl http://localhost:33333/kdb/user/test
+```
+
+will return us the value of the specified key `user/test`, which is stored in the database right now
+
+<!-- prettier-ignore-start -->
+```json
+{
+    "exists": true,
+    "name": "test",
+    "path": "user/test",
+    "ls": [
+        "user/test"
+    ],
+    "value": "5",
+    "meta": ""
+}
+```
+<!-- prettier-ignore-end --> 
+
 ## Auth
 
 Currently, webd does not support authentication. The best way to work around