使用Postman访问数据

MemFire Cloud为所有的数据表提供自动即时的API，我们可以通过Postman工具调用API来访问云数据库中数据表的数据。

前置条件

① 注册MemFire Cloud账号；

② 存在已创建好的应用；

操作步骤

1.创建数据表，插入数据

在我的应用管理页面，点击具体应用，进入应用详情页面，点击左侧菜单栏“数据表”。点击“新建数据表”按钮，创建数据表“employees”，如下图所示。

点击“插入行”按钮，插入如下数据。

2.使用API文档

点击右侧的菜单栏的“api文档”，在“所有数据表”里点击自己需要查询的数据表，再在右侧点击“Bash”,应用api Key 选择公开密钥，下面会出现这个表的专属api文档。

点击左侧菜单栏“API文档”。选中所有数据表中的“employees”，右侧点击"Bash"栏，应用API key选择“公开(anno)”, 则会出现上图所示的该数据表的专属文档。

3.访问数据

接下来读取该数据表“employees"中所有的行。

1、首先，我们在拖动文档滚动条，找到该操作的命令，如下图所示。我们可以直接获取到命令的URL信息、apikey和Authorization。

2.打开Postman工具，新建一个请求窗口，复制url并将其粘贴到请求里，请求方式选择GET，查询参数是“*”（查询全部）。

3.配置请求Headers,将apikey和Authorization配置到请求头里面。

4.点击“Send”按钮，即可获得返回结果。

4.插入数据

接下来插入数据到数据表“employees"中。

1、首先，我们在拖动文档滚动条，找到插入一行数据的命令，如下图所示。我们可以直接获取到命令的URL信息、apikey和Authorization。

2、在Postman工具，新建一个请求窗口，请求方式选择POST，复制url并将其粘贴到请求里，配置Headers。

3、在Body里面配置需要插入的数据。

4、点击“Send”按钮，返回状态码201，插入数据操作成功。

5、执行访问数据操作，可以查看到插入成功的一条数据。

5.设置RLS, 访问数据

接下来展示如何采用RLS来设置表的访问权限，允许经过身份验证的用户来访问数据表。

1、在数据表页面，选中数据表“employees"，切换到表权限页面。点击“启用RLS”按钮后，启用了RLS规则。

2、接下来，给表设置访问规则，只允许经过身份验证的用户才能去插入数据。这只是其中一种规则，具体规则还得根据大家的业务需求规定。

允许所有用户访问数据表。

创建规则成功后，显示结果如下：

备注说明：设置完成权限后，此时第4小节中插入数据将无法成功，提示如下。

3、接着，创建一个用户，在认证管理->用户管理页面，点击“邀请新用户”按钮，输入你的邮箱地址，点击“发送邀请”按钮。则该邀请邮箱中会收到一份注册邀请邮件；

4、登录邮箱接受注册邀请，可以拿到用户token，这说明该用户已经认证通过。

点击邮件中的邀请链接，在浏览器新页面中打开，可以从邀请链接中获取该用户的token。

5、打开Postman，执行打开上一步的插入数据请求窗口，将Authorization 的内容换成该用户的token。

6、配置apikey、Perfer、Content-type参数。

7、Body中，准备一条即将插入的数据，如下图。

8、点击“Send”按钮，返回状态码201，插入数据操作成功。