Kv 缓存

1.功能描述

控制面的Sendmsg模块提供了可选的配置指令dyn_sendmsg_kv, 这个指令将对外提供KV 值设置及查询的 HTTP API 接口。

2.API

通过在控制面的配置文件中,添加一个location, 并在location 中使用dyn_sendmsg_kv指令开启KV HTTP API。以下的配置示例中的端口及URL 可以根据需要进行更改。

   server {
         listen 8081;
          location /api {
        dyn_module_api;
         }
     }

2.1 API 说明

通过配置的location 的url,使用POST方法,设置key value 值, 提交的报文为JSON格式。

以下请求请注意替换IP 、端口 、URL,与实际的配置需要一致

设置KV值

请求:

POST http://127.0.0.1:8081/api/v1/kv
Content-Type: application/json

 {
    "key":"sc_test_key", 
    "value":"here is the test msg"
 }

返回:

HTTP/1.1 200 OK
Server: njet/1.23.1
Date: Tue, 07 Mar 2023 08:10:20 GMT
Content-Length: 0
Connection: keep-alive

查询key value 值

请求:

GET http://127.0.0.1:8081/api/v1/kv?key=sc_test_key

返回:

HTTP/1.1 200 OK
Server: njet/1.23.1
Date: Tue, 07 Mar 2023 08:14:38 GMT
Content-Type: text/plain
Content-Length: 20
Connection: keep-alive
 

here is the test msg